第 2 版 前 言 


《Android 府 入 式 系统 程序 开发 〈 基 于 Cotrtex-A8) 》 一 书 ， 自 2013 年 4 月 由 机 械 工业 出 版 社 出 版 后 ， 分 别 在 2013 年 和 2014 年 重印 两 次 ， 在 此 类 专业 图 书 教材 中 表现 相当 突出 。 作 者 非常 感谢 购买 本 书 的 读 
者 ， 尤 其 是 那些 能 够 通过 网 络 提出 问题 讨论 并 给 出 建议 或 指出 错误 的 读者 朋友 。 根 据 最 近 几 年 Android 的 发 展 变化 、 开 发 平台 软件 和 开发 工具 的 更 新 等 相关 资料 ， 以 及 近 几 年 笔者 在 学 校 、 公 司 从 事 教学 与 培 
训 中 的 经 验 和 积累 ， 决 定 对 本 书 进行 升级 以 适应 快速 狗 代 的 市 场 变化 。 


本 书 在 第 1 版 内 容 的 基础 上 修改 了 部 分 内 容 ， 主 要 内 容 包括 : 更 新 第 2 章 Android 应 用 程序 开发 内 容 ， 增 加 了 界面 布局 、 菜 单 和 事件 处 理 内 容 ; 新 增 第 3 章 数据 库 应 用 程序 开发 ， 增 加 本 地 SQLite 数 据 库 应 用 
程序 ， 以 及 远程 数据 库 访问 应 用 程序 ; 根据 读者 的 建议 ， 修 改 S5PV210 硬 件 结构 与 接口 驱动 程序 部 分 内 容 ， 涉 及 第 5 章 系统 硬件 及 驱动 程序 ， 以 及 第 6 章 外 设 接口 及 驱动 程序 ， 实 现 了 硬件 接口 、 上 层 UI 界 面 
程序 和 中 间 层 JNI 程 序 结合 的 驱动 程序 ; 修改 了 第 7 章 并 更 换 了 第 9 章 的 实例 ， 使 得 初学 者 更 容易 理解 和 接受 相关 知识 。 


尽管 笔者 设计 和 开发 过 许多 实际 的 应 用 项 目 和 产品 ， 但 考虑 到 本 书 读者 主要 是 初学 者 ， 通 常 不 可 能 具备 与 掌握 开发 各 种 实际 项 目 或 产品 所 涉及 的 相关 知识 和 基础 ， 所 以 提供 完整 的 综合 应 用 项 目的 程序 
开发 实例 。 再 版 书 中 的 实例 源 代码 放 在 华章 网 站 上 ， 包 括 应 用 程序 开发 、 数 据 库 应 用 程序 开发 ， 系 统 硬件 及 驱动 程序 、 外 设 接口 及 驱动 程序 和 综合 应 用 项 目的 程序 开发 实例 等 源 代码 。 


本 书 在 编写 过 程 中 ， 得 到 了 许多 专家 和 学 者 的 大 力 支 持 ， 听 取 了 多 方面 的 宝贵 意见 和 建议 ， 在 此 对 他 们 表示 衷心 感谢 。 书 中 难免 存在 不 足 和 错误 之 处 ， 敬 请 读者 批评 指正 。 
编者 


2015 年 4 月 


第 1 版 前 言 


本 书 的 特点 是 以 训 入 式 操作 系统 Android 和 Cortex-A8 微 处 理 器 S5SPV210 为 基础 ， 从 Android 体 系 结 构 和 搭建 开发 环境 ， 以 及 Android 应 用 程序 开发 等 方面 构造 了 一 个 完整 的 Android 开 发 流程 。 本 书 重点 介绍 
了 S5PV210 硬 件 结构 和 Android 系 统 移植 ， 详 细 讲 解 了 底层 驱动 的 封装 、 中 间 层 JNI 的 制作 ， 以 及 上 层 UI 的 设计 ， 采 用 Java 开 发 接口 驱动 程序 。 本 书 还 提供 了 完整 的 综合 应 用 项 目的 程序 开发 实例 ， 介 绍 了 功能 
模块 设计 和 数据 库 设 计 ， 详 细 讲解 了 开发 过 程 与 程序 源 代码 ; 使 读者 深刻 理解 和 掌握 嵌入 式 系 统 开 发 的 整个 过 程 ， 了 解 底层 驱动 程序 驱动 硬件 的 原理 和 上 层 应 用 程序 的 设计 方法 ， 真 正 做 到 了 底层 驱动 的 开 
发 与 上 层 应 用 程序 的 开发 相 结合 。 


本 书 内 容 丰富 实用 、 氢 述 详尽 清晰 ， 方 便 教学 与 自学 。 结 合 DMA-210XP 平 台 的 实验 程序 ， 有 利于 读者 掌握 Android 系 统 的 应 用 程序 设计 方法 ， 培 养 读者 综合 分 析 、 开 发 创新 和 工程 设计 的 能 力 。 通 过 本 书 
的 学 习 ， 读 者 可 以 快速 提高 Android 的 编程 能 力 和 实际 开发 水 平 。 


全 书 分 三 部 分 ， 共 9 章 。 

第 一 部 分 : 软件 篇 

“ 第 1 章 介绍 了 Android 的 体系 结构 ， 以 及 Android 系 统 的 整体 架构 的 各 层 组 成 ， 并 介绍 了 如 何 搭建 Windows、Linux 和 NDK 下 的 开发 环境 。 

- 第 2 章 介绍 了 第 一 个 HelloEveryone 的 Androiqd 应 用 程序 ， 以 及 Android 应 用 程序 组 成 ， 并 介绍 如 何 使 用 Android Manifest 文 件 定义 应 用 程序 。 

“ 第 3 章 介绍 了 Android 应 用 程序 开发 过 程 中 涉及 的 控件 ， 介 绍 了 Activity 转 换 和 Intent 消 息 传 递 、Menu 设 计 修改 、 对 话 框 实例 和 Android 本 地 数据 库 SQLite 应 用 。 

第 二 部 分 : 硬件 篇 

- 第 4 章 详细 介绍 了 Android 内 核 结 构 和 设备 驱动 、Android 内 核 基 本 配置 、Android 内 核 编译 和 DMA-210XP 平 台 Android 文 件 系统 烧 写 过 程 。 

- 第 5 章 介绍 了 S5PV210 的 硬件 结构 ， 包 括 S5PV210 微 处 理 器 、GPIO 接 口 、PWM 定 时 器 、DMA 控 制 器 、UART 串 行 接口 、SPI 接 口 、IIC 总 线 接 口 和 ADC 及 触摸 屏 接 口 。 介 绍 了 接口 应 用 实例 及 驱动 程序 。 


- 第 6 章 介绍 了 在 Androiqd 开 发 环境 下 ， 采 用 Java 编 写 接口 驱动 程序 。 包 括 LED 接 口 及 驱动 程序 、 背 光 调 节 控 制程 序 、 键 盘 接口 及 驱动 程序 、UART 串 行 口 及 通信 程序 、ZigBee 接 口 及 驱动 程序 、Wi-Fi 接 口 
及 通信 程序 、3G 接 口 及 驱动 程序 、MediaPlayet 播 放 器 程序 等 。 


第 三 部 分 : 项 目 篇 

“ 第 7 章 介 绍 了 嵌入 式 组 态 软 件 结 构 ， 以 及 界面 设计 、 功 能 选择 区 设计 、 辅 助 功 能 区 设计 和 程序 生成 区 设计 Android 应 用 ， 采 用 Java 开 发 赔 入 式 组 态 软 件 。 

+ 第 8 章 以 MyMap 服 务 系统 为 实例 ， 介 绍 Android Google Map、Android 定 位 服务 、 案 例 重 构 ， 采 用 Java 开 发 GPS 与 Google Map 定 位 应 用 程序 。 

+ 第 0 章 以 3D 传 感 器 动力 球 游戏 为 例 ， 介 绍 小 球 快 跑 游 戏 背 景 及 功能 、 游 戏 的 架构 ， 详 细 讲 解 了 游戏 主 菜单 、 游 戏 界面 模块 ， 游 戏 中 各 个 层 、 游 戏 后 台 逻 辑 和 传感器 计算 模块 等 的 程序 开发 。 


本 书 由 胡 文 教授 拟定 编写 大 岗 和 目录 。 胡 文 编写 了 第 6 章 和 第 7 章 ， 宁 世 勇 编写 了 第 2 章 和 第 3 章 ， 李 明俊 编写 了 第 1 章 、 第 8 章 和 第 9 章 ， 金 雪松 编写 了 第 4 章 和 第 5 章 。 百 度 公司 的 胡 班 ， 哈 尔 滨 商 业 大 学 的 
李杨 、 赵 艳丽 、 张 凯 、 陈 楠 等 人 为 本 书 的 编写 做 了 大 量 的 工作 ， 在 此 一 并 表示 衷心 感谢 。 本 书 在 编写 过 程 中 ， 参 考 了 大 量 的 国内 外 著作 和 资料 ， 得 到 了 许多 专家 和 学 者 的 大 力 支 持 ， 并 听取 了 多 方面 的 宝贵 
意见 和 建议 ， 在 此 也 对 他 们 表示 衷心 感谢 。 


由 于 时 间 仓促 和 作者 水 平 所 限 ， 本 书 难 免 有 跤 漏 和 不 足 之 处 ， 司 请 各 位 读者 批评 指正 ， 以 期 再 版 时 修订 。 
编者 


2013 年 1 月 


软件 篇 


“ 第 1 章 Android 体 系 结构 及 开发 环境 
"第 2 章 ”Android 应 用 程序 开发 


+ 第 3 章 ” SQLite 数据 库 程 序 开发 


Android 是 Google 公 司 为 移动 设备 开发 的 平台 ， 它 是 一 款 开 放 的 软件 系统 ， 其 系统 体系 结构 如 图 1-1 所 示 ， 自 上 而 下 分 为 以 下 几 个 层次 。 
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图 1-1 Android 系 统 体系 结构 
“ 应 用 程序 (Application) 
+ 应 用 程序 框架 (Application Framework) 
- 函数 库 (Libraries) 和 Android 运 行 时 (Android Runtime) 


- Linux 4% (Linux Kernel) 


Android 的 内 核 系 统 服务 依赖 于 Linux2.6 内 核 ， 随 着 Android 发 布 版 本 的 升级 ，Android 系 统 使 用 的 Linux 内 核 也 在 不 断 升 级 ， 下 面 仅 列举 到 Android 2.3 版 本 。 与 Android 系 统 对 应 的 内 核 及 其 版 本 如 


Android 系统 版 本 内 核 版 本 

Android 1.0 Linux 2.6.25 

Android 1.5 (Cupcake) ^ Linux 2.6.27 
Android 1.6 (Donut) Linux 2.6.29 
Android 2.1 (Eclair) ^ Linux 2.6.29 
Android 2.2 (Froyo) ^ Linux 2.6.32 


Android 2.3 (GingerBread) Linux 2.6.35 


在 本 节 中 将 对 每 一 层次 进行 简单 说 明 。 


1.1.1 应 用 程序 


Android 应 用 程序 是 基于 Java 语 言 编写 的 ， 为 使 用 者 提供 操作 接口 。 使 用 者 直接 操作 应 用 程序 ， 实 现 一 定 的 功能 。 目 前 Android 系 统 提供 了 计算 器 、 联 系 人 (Contacts) 、 电 话 (Phone) 、 浏 览 器 
(Browser) 、E-mail 客 户 端 、SMS 短 消息 程序 、 日 历 、 地 图 等 内 核 应 用 程序 ， 开 发 者 还 可 以 使 用 Android 提 供 的 组 件 编写 满足 特定 功能 的 应 用 程序 。 


由 用 户 开 发 的 Android 应 用 程序 和 Android 内 核 应 用 程序 是 同一 层次 的 ， 它 们 都 是 基于 Android 系 统 的 API 构 建 的 。 


1.1.2 ”应 用 程序 框架 


程序 体系 结构 所 发 布 的 


开发 人 员 可 以 访问 内 核 应 用 程序 所 使 用 的 AP 框架。 应 用 程序 体系 结构 设计 简化 了 组 件 的 重用 ， 任 何 一 个 应 用 程序 都 可 以 发 布 其 功能 块 ， 并 且 任 何其 他 的 应 用 程序 都 可 以 使 用 应 
功能 块 (不 过 要 遵循 框架 的 安全 性 限制 ) 。 同 样 ， 应 用 程序 重用 机 制 也 使 使 用 者 可 以 方便 地 蔡 换 程序 组 件 。 隐 藏 在 每 个 应 用 后 面 的 是 一 系列 的 系统 服务 ， 这 些 系统 服务 包括 : 


' 丰富 且 可 扩展 的 视图 (View System) ， 可 以 用 来 构建 应 用 程序 ， 这 些 视 图 包括 列表 (List) 、 网 格 (Grid) 、 文 本 块 (Text Box) 、 按 钮 (Button) ， 甚 至 可 嵌入 Web 浏 览 器 。 


“ 内容 提 供 器 (Content Provider) 使 应 用 程序 可 以 访问 另 一 个 应 用 程序 的 数据 (如 联系 人 数据 库 ) ， 或 者 共享 它们 自己 的 数据 。 


- 资源 管理 器 (Resource Manager) 提供 非 程 序 代码 资源 的 访问 ， 如 本 地 字符 串 、 图 形 和 布局 文件 (Layout File) o 
“ 通知 管理 器 (Notification Manager) 使 得 应 用 程序 可 以 在 状态 列 中 显示 自 定义 的 提示 信息 。 

“ 活动 管理 器 (Activity Manager) 用 来 管理 应 用 程序 生命 周期 并 提供 常用 的 导航 回 退 功能 。 

: 窗口 管理 器 (Window Manager) 管理 所 有 窗口 程序 。 

- 包 管 理 器 (Package Manager) 管理 Android 系 统 内 的 程序 。 

“ 通信 管理 器 (Telephony Manager) 管理 Android 系 统 的 通信 功能 。 


- 定位 管理 器 (Location Manager) 提供 Android 系 统 的 定位 等 相关 服务 。 


1.1.3 Reve 


Android 包 含 一 些 C/C+ + 函数 库 ， 这 些 函 数 库 能 被 Android 系 统 中 不 同 的 组 件 使 用 。 它 们 通过 Android 应 用 程序 框架 为 开发 者 提供 服务 。 这 些 内 核 函 数 库 包括 : 


Шс: 标准 C 系 统 函 数 库 ， 它 是 专门 为 基于 Embedded Linux 的 设备 定制 的 。 

* Media Framework: 基于 PacketVideo OpenCORE ， 该 函数 库 支持 多 种 常用 的 音效 、 视 频 格式 回放 和 录制 ， 同 时 支持 静态 影像 文件 。 编 码 格式 包括 MPEG4、H.264、MP3、AAC、AMR、JPG 以 及 PNG。 
“ Surface Manager: 显示 子 系统 的 管理 ， 并 且 为 多 个 应 用 程序 提供 了 2D 和 3D 图 层 的 无 颖 融合 。 

< Webkit: 提供 Web 浏 览 引 营 的 支持 。 

561: 底层 的 2D 图 形 引擎 。 

+ OpenGL ES: 基于 OpenGL ES 1.0 APIS 实 现 ， 该 函数 库 可 以 使 用 硬件 3D 加 速 (WRTA) 或 者 使 用 高 度 优 化 的 3D 软 加 速 。 

+ FreeType: 位 图 (bitmap) 和 向 量 (vector) 字体 显示 。 

| SQLite: 一 个 对 于 所 有 应 用 程序 可 用 、 功 能 强大 的 轻 量 级 关系 型 数据 库 引 擎 。 


“SSL: 安全 套 接 层 (Secure Sockets Layer) 是 为 网 络 通信 提供 安全 及 数据 完整 性 的 一 种 安全 协议 。 


1.1.4 Linux 内 核 


Android 的 内 核 系 统 服务 如 安全 管理 、 内 存 管理 、 进 程 管理 、 网 络 通信 和 驱动 模型 依赖 于 Linux 2.6 内 核 ，Linux 内 核 也 同时 作为 硬件 和 软件 堆栈 之 间 的 抽象 层 。 关 于 Android 对 Linux 内 核 的 修改 ， 这 里 
阐述 以 下 两 个 : 


: Binder (IPC) Driver: 提供 高 效率 的 进程 间 通 信 (Inter-Process Communication) 。Android 系 统 中 有 很 多 服务 ， 上 层 的 应 用 程序 经 常 要 取 用 这 些 服务 。 虽 然 一 般 的 Linux 系 统 已 经 提供 了 很 多 IPC 的 方式 ， 
但 是 Android 几 乎 重新 制作 了 一 套 自己 的 IPC。Android 文 件 中 解释 说 ， 一 般 IPC 会 造成 额外 资源 花费 以 及 安全 问题 。 

+ Power Management: 与 台式 计算 机 或 笔记 本 电脑 不 同 ， 手 持 设备 的 电源 一 向 相当 有 限 ， 必 须 想 尽 一 切 办 法 省 电 ， 而 又 不 能 影响 顺畅 的 使 用 体验 。Android 在 此 采取 了 颇 为 积极 的 做 法 : 如 果 不 使 用 ， 就 
关 掉 。 例 如 ， 某 程序 在 播放 MP3 音 乐 ， 于 是 此 程序 需要 CPU 的 计算 能 力 ， 那 系统 就 得 提供 。 如 果 与 此 同时 没有 执行 其 他 程序 ， 那 么 LCD 显 示 器 就 可 能 被 关闭 ， 以 便 省 电 。 一 般 的 Linux 内 核 考虑 的 都 是 在 计算 
机 上 的 做 法 ， 所 以 多 数 只 有 进入 暂停 、 休 有 眠 等 选择 ， 而 不 会 如 此 细致 地 控制 各 个 小 装置 的 电源 供应 。 


以 上 详细 介绍 了 Android 体 系 结构 情况 ， 读 者 可 以 了 解 了 Android 体 系 结构 的 基本 情况 ， 为 开发 Android 应 用 程序 打下 基础 。 在 开发 Android 应 用 程序 之 前 首先 需要 搭建 开发 的 环境 ， 下 面 将 介绍 
Android 应 用 程序 开发 环境 是 如 何 搭建 的 。 


第 1 章 Android 体 系 结构 及 开发 环境 


11 Android 体系 结构 介绍 


Android 是 Google 公 司 为 移动 设备 开发 的 平台 ， 它 是 一 款 开 放 的 软件 系统 ， 其 系统 体系 结构 如 图 1-1 所 示 ， 自 上 而 下 分 为 以 下 几 个 层次 。 
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图 1-1 ”Android 系统 体系 结构 
“ 应 用 程序 (Application) 
: 应 用 程序 框架 (Application Framework) 
- 函数 库 (Libraries) 和 Android 运 行 时 (Android Runtime) 


- Linux 内 核 (Linux Kernel) 


Android 的 内 核 系 统 服务 依赖 于 Linux2.6 内 核 ， 随 着 Android 发 布 版 本 的 升级 ，Android 系 统 使 用 的 Linux 内 核 也 在 不 断 升 级 ， 下 面 仅 列举 到 Android 2.3 版 本 。 与 Android 系 统 对 应 的 内 核 及 其 版 本 如 


Android 系统 版 本 内 核 版 本 

Android 1.0 Linux 2.6.25 

Android 1.5 (Cupcake) ^ Linux 2.6.27 
Android 1.6 (Donut) Linux 2.6.29 
Android 2.1 (Eclair) ^ Linux 2.6.29 
Android 2.2 (Froyo) ^ Linux 2.6.32 


Android 2.3 (GingerBread) Linux 2.6.35 


在 本 节 中 将 对 每 一 层次 进行 简单 说 明 。 


Android 应 用 程序 是 基于 Java 语 言 编写 的 ， 为 使 用 者 提供 操作 接口 。 使 用 者 直接 操作 应 用 程序 ， 实 现 一 定 的 功能 。 目 前 Android 系 统 提供 了 计算 器 、 联 系 人 (Contacts) 、 电 话 (Phone) 、 浏 览 器 
(Browser) 、E-mail 客 户 端 、SMS 短 消息 程序 、 日 历 、 地 图 等 内 核 应 用 程序 ， 开 发 者 还 可 以 使 用 Android 提 供 的 组 件 编写 满足 特定 功能 的 应 用 程序 。 


由 用 户 开 发 的 Android 应 用 程序 和 Android 内 核 应 用 程序 是 同一 层次 的 ， 它 们 都 是 基于 Android 系 统 的 API 构 建 的 。 


程序 体系 结构 所 发 布 的 


开发 人 员 可 以 访问 内 核 应 用 程序 所 使 用 的 AP 框架 。 应 用 程序 体系 结构 设计 简化 了 组 件 的 重用 ， 任 何 一 个 应 用 程序 都 可 以 发 布 其 功能 块 ， 并 且 任 何其 他 的 应 用 程序 都 可 以 使 用 应 
功能 块 (不 过 要 遵循 框架 的 安全 性 限制 ) 。 同 样 ， 应 用 程序 重用 机 制 也 使 使 用 者 可 以 方便 地 蔡 换 程序 组 件 。 隐 藏 在 每 个 应 用 后 面 的 是 一 系列 的 系统 服务 ， 这 些 系统 服务 包括 : 


“ 丰富 且 可 扩展 的 视图 (View System) ， 可 以 用 来 构建 应 用 程序 ， 这 些 视图 包括 列表 (List) + MH (Grid) . LAR (Text Box) . #42 (Button) , LA Г ANWebi 8. 
.内容 提供 器 (Content Provider) 使 应 用 程序 可 以 访问 另 一 个 应 用 程序 的 数据 〔 如 联系 人 数据 库 ) ， 或 者 共享 它们 自己 的 数据 。 

+ 资源 管理 器 (Resource Manager) 提供 非 程序 代码 资源 的 访问 ， 如 本 地 字符 串 、 图 形 和 布局 文件 (Layout File) 。 

+ 通知 管理 器 (Notification Manager) 使 得 应 用 程序 可 以 在 状态 列 中 显示 自 定义 的 提示 信息 。 

+ 活动 管理 器 (Activity Manager) 用 来 管理 应 用 程序 生命 周期 并 提供 常用 的 导航 回 退 功能 。 

- 窗口 管理 器 (Window Manager) 管理 所 有 窗口 程序 。 

- 包 管 理 器 (Package Manager) 管理 Android 系 统 内 的 程序 。 

“ 通信 管理 器 (Telephony Manager) 管理 Android 系 统 的 通信 功能 。 


- 定位 管理 器 (Location Manager) 提供 Android 系 统 的 定位 等 相关 服务 。 


1.1.3 RUE 


Android 包 含 一 些 C/C+ + 函数 库 ， 这 些 函 数 库 能 被 Android 系 统 中 不 同 的 组 件 使 用 。 它 们 通过 Android 应 用 程序 框架 为 开发 者 提供 服务 。 这 些 内 核 函 数 库 包 括 : 


0с: 标准 C 系 统 函数 库 ， 它 是 专门 为 基于 Embedded Linux 的 设备 定制 的 。 

* Media Framework: 基于 PacketVideo OpenCORE ， 该 函数 库 支 持 多 种 常用 的 音效 、 视 频 格 式 回放 和 录制 ， 同 时 支持 静态 影像 文件 。 编 码 格式 包括 MPEG4、H.264、MP3、AAC、AMR、JPG 以 及 PNG。 
+ Surface Manager: 显示 子 系统 的 管理 ， 并 且 为 多 个 应 用 程序 提供 了 2D 和 3D 图 层 的 无 缝 融 合 。 

:Webkit: 提供 Web 浏 览 引 营 的 支持 。 

“ SGL: 底层 的 2D 图 形 引擎 。 

+ OpenGL ES: 基于 OpenGL ES 1.0 APIS 实 现 ， 该 函数 库 可 以 使 用 硬件 3D 加 速 (如 果 可 用 ) 或 者 使 用 高 度 优化 的 3D 软 加 速 。 

- FreeType: 位 图 (bitmap) 和 向 量 (vector) 字体 显示 。 

| SQLite: 一 个 对 于 所 有 应 用 程序 可 用 、 功 能 强大 的 轻 量 级 关系 型 数据 库 引 擎 。 


“SSL: 安全 套 接 层 (Secure Sockets Layer) 是 为 网 络 通信 提供 安全 及 数据 完整 性 的 一 种 安全 协议 。 


1.1.4 Linux 内 核 


Android 的 内 核 系统 服务 如 安全 管理 、 内 存 管理 、 进 程 管理 、 网 络 通信 和 驱动 模型 依赖 于 Linux 2.6 内 核 ，Linux 内 核 也 同时 作为 硬件 和 软件 堆栈 之 间 的 抽象 层 。 关 于 Android 对 Linux 内 核 的 修改 ， 这 里 
时 点 阐述 以 下 两 个 : 


由 | 


: Binder (IPC) Driver: 提供 高 效率 的 进程 间 通 信 (Inter-Process Communication) 。Android 系 统 中 有 很 多 服务 ， 上 层 的 应 用 程序 经 常 要 取 用 这 些 服务 。 虽 然 一 般 的 Linux 系 统 已 经 提供 了 很 多 IPC 的 方式 ， 
但 是 Android 几 乎 重新 制作 了 一 套 自己 的 IPC。Android 文 件 中 解释 说 ， 一 般 IPC 会 造成 额外 资源 花费 以 及 安全 问题 。 


+ Power Management: 与 台式 计算 机 或 笔记 本 电脑 不 同 ， 手 持 设备 的 电源 一 向 相当 有 限 ， 必 须 想 尽 一 切 办 法 省 电 ， 而 又 不 能 影响 顺畅 的 使 用 体验 。Android 在 此 采取 了 磊 为 积极 的 做 法 : 如 果 不 使 用 ， 就 
关 掉 。 例 如 ， 某 程序 在 播放 MP3 音 乐 ， 于 是 此 程序 需要 CPU 的 计算 能 力 ， 那 系统 就 得 提供 。 如 果 与 此 同时 没有 执行 其 他 程序 ， 那 么 LCD 显 示 器 就 可 能 被 关闭 ， 以 便 省 电 。 一 般 的 Linux 内 核 考 虑 的 都 是 在 计算 
机 上 的 做 法 ， 所 以 多 数 只 有 进入 暂停 、 休 眠 等 选择 ， 而 不 会 如 此 细致 地 控制 各 个 小 装置 的 电源 供应 。 


以 上 详细 介绍 了 Android 体 系 结构 情况 ， 读 者 可 以 了 解 了 Android 体 系 结构 的 基本 情况 ， 为 开发 Android 应 用 程序 打下 基础 。 在 开发 Android 应 用 程序 之 前 首先 需要 搭建 开发 的 环境 ， 下 面 将 介绍 
Android 应 用 程序 开发 环境 是 如 何 搭建 的 。 


1.2 ”搭建 Windows 下 的 开发 环境 


在 搭建 Windows 下 的 开发 环境 之 前 ， 必 须 先 下 载 Android SDK 组 件 、Eclipse 以 及 JDK (Java Development Kit) 组 件 (因为 Android 的 应 用 程序 是 采用 Java 语 言 编写 的 ) 。 


1.2.1 安装 JDK 


安装 Eclipse 的 开发 环境 需要 JRE 的 支持 ， 如 果 没 有 JRE， 则 启动 Eclipse 时 会 报告 错误 。 在 Windows XP 上 安装 JRE/JDK 非 常 简单 ， 步 骤 如 下 : 


1) 从 sun 公司 官方 网 站 下 载 最 新 版 的 JDK。 


2) 双击 JDK 安 装 文件 ， 打 开 安 装 向 导 ， 然 后 按照 默认 的 设置 点 击 “ 下 一 步 ” 进 行 安装 。 默 认 情况 下 JDK 的 安装 路 径 为 : C:\Program Files\Java (这 里 以 C 盘 为 系统 盘 ) 。 安 装 完成 后 还 需 设 定 JDK 的 环 
境 变 量 ， 将 JDK 的 bin 文 件 的 路 径 C\Program Files\Java\jdk1.6.0_14\bin 添 加 到 path 中 。 上 有 具体 做 法 是 : 右 击 “我 的 电脑 ”， 点 击 “ 属 性 ”， 打 开 “ 系 统 属性 ”对 话 框 ， 在 其 “高 级 ”选项 卡 中 点 击 “ 环 境 变 
E” 按钮 ， 打 开 “ 环 境 变量 ”对 话 框 ， 选 择 “ 系 统 变量 ”列表 中 的 “Path” 选 项 ， 如 图 1-2 所 示 。 


点 击 “ 编 辑 ” 按 钮 ， 添 加 JDK 目 录 中 bin 文 件 所 在 路 径 即 可 ， 末 尾 要 以 半角 的 分 号 结尾 ， 如 图 1-3 所 示 。 


| 自动 更 新 | 远程 


Administrator 的 用 户 变量 (U) 


жа 值 

MOZ PLUGIN PATH C:\Program Files\Foxit Software... 
TEMP C:\Documents and Settings Admin. .. 
ТИР C:\Documents and Settings Admin... 


系统 变量 (S) 


(ë 

Windows NT 

С: ^WINDOWS^syztem3z;C: WINDÜWS;.. 

„СОМ: . EXE; . BAT; . CMD; . VBS; .VBE;... 
_ ID... x86 Family B Model 15 Stepping . 


| 常规 | 计算 机 名 Be | 高 级 。 | 自动 更 新 | 远程 
Ff FAP m: 


Administrator ВОН Р ЖЕЕ (U) 
щн = k SP єн 


Windows NT 

C: WINDOWS*system32:C: WINDOWS: .. 
PATHEXT .,UO0M;.EXE;.BAT;.CMD;.VBS;.VBE;.... 
PROCESSOR AR... x86 
PROCESSOR ID... x66 Family 6 Model 15 Stepping... 


ТРИЕ СЯ Е РЕР Tm ё 


— — 
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配置 完成 后 ， 点 击 “ 确 定 ”按钮 退出 。 


3) 下 面 测试 安装 是 否 成 功 。 点 击 “ 开 始 ” 一 “运行 ”， 在 出 现 的 窗口 中 输入 “cmd” 命令， 在 弹出 的 命令 窗口 中 输入 命令 : java-version， 如 果 出 现 图 1-4 所 示 信 息 ， 则 说 明 JDK 安 装 成 功 。 


-joj x 


C:\WINDOWS\system32\cmd.exe 
icrosoft Windows XP che 25 5.1.268081 
<C> hRTWPIH 1985-2001 Microsoft Corp. 


C:\Documents and Settings\Administrator>java -version 


java version "1.6.8 14" 
JavactIM> SE Runtime Environment build 1.6.8,14-b84»5 
Java HotSpot<TM> Client UM «build 16.2-b804, mixed mode, sharing? 


C:\Documents and Settings\Administrator>javac -version 
javac 1.6.8 14 


C:\Documents and Settings \Administrator> 


图 1-4 检测 配置 信息 


JDK 安 装 完成 之 后 ， 就 可 以 安装 Eclipse 了 。 安 装 步骤 如 下 : 


1) 从 Eclipse 官方 网 站 下 载 最 新 版 的 Eclipse。 


2) 下 载 完成 之 后 ， 解 压 Eclipse 压缩 包 文件 ， 然 后 进入 解压 目录 ， 可 以 看 到 一 个 名 为 eclipse.exe 的 可 执行 文件 。 


3) 双击 eclipse.exe 文 件 ， 即 可 直接 运行 Eclipse。 如 果 是 第 一 次 启动 Eclipse， 将 会 看 到 一 个 选择 工作 目录 (Workspace) 的 提示 ， 如 图 1-5 所 示 。 


= Workspace Launcher 


Select a workspace 


Eclipse Platform stores your projects in a Folder called a workspace. 
Choose 4 workspace folder to use for this session. 


Workspace: Browse... 


| |Use this as the default and do not ask again 


图 1-5 选择 工作 目录 


在 Workspace 栏 内 输入 指定 的 工作 路 径 ， 然 后 点 击 “OK” 按钮 即 可 。 


2.3 = 


属 的 开发 环境 ， 包 括 创建 Android 开 发 实例 、 执 行 和 调试 Android 程 序 。 


成 功 安装 Eclipse 之 后 ， 还 需要 安装 ADT 开 发 工具 。ADT 用 于 为 Eclipse 打 造 一 个 Android 专 


1) 首先 下 载 ADT 插 件 ， 与 Android 2.1 对 应 的 版 本 为 ADT-0.9.6。ADT 下 载 网 址 为 : http://androidappdocs.appspot.com/sdk/eclipse-adt.html。 


2) 下 载 完成 后 ， 启 动 Eclipse， 在 Eclipse 界面 内 点 击 菜单 栏 中 的 “Help” 一 “Software Updates”。 如 图 1-6 所 示 。 


3) 进入 Software Updates and Add-ons 窗 口 ， 其 中 有 两 个 选项 卡 ， 分 别 是 Installed software 和 Available Software， 如 图 1-7 所 示 。 


= Java - Eclipse Platform Ж b | 
File Edit Refactor Bun  Mavigate Search Project Window | 0 


F3 im! Б = = Gr D cm AT dis. E) Welcome 
| Ter o,r: A: л W (2) Help Centerts 
p Search 


Dynamic Нер 


Key Assist... CEr| +ShiFE--L 
Tips and Tricks... 

调 Report Bug or Enhancement... 
Cheat Sheets... 


Software Updates... 


АБош Eclipse Platform 


Android SOK Content Loader 


图 1-6 ik4f "Software Updates” 44 


- Software Updates and Add-ons 


Installed Software | Aveilable Software 


0,9,6,v20 100208 
Whe Apache MyFaces Trinidad Tag Support (Opti... 2.1. 0.v200901 25 
Чр Axis Tools (Optional 1.0,3,v 2009012; 
Up Data Tods Platform Connectivity 1.6.2.v2008 1007 
Gk Data Tods Platform Enablement 1.6.2,¥2008100; 
uhh Data Tools Platform Enablement Fer Apache... 1.6.2.v2008100; 


Mk Data Tools Platform Enablement Fer HSQLDB — «1.6.2, v2008100; 
Wok Data Tools Platform Enablement For IBM 1.6.2.¥2008100; 
Wek Data Tools Platform Enablement for JDBC 1.6.2.¥2008100; 


|^ __. L=: 


F 


图 1-7 Software Updates and Add-ons @ 7 


4) 由 于 已 经 得 到 了 ADT 文 件 ， 所 以 选择 Available Software 选 项 卡 直接 安装 即 可 ， 点 击 “Add site” 按 钮 ， 并 在 Add Site 对 话 框 中 输入 存放 ADT 的 路 径 ， 如 图 1-8 所 示 。 


5) gu; "OK" 按钮 退出 对 话 框 。 然 后 在 Available Software 选 项 卡 中 找到 Developer Tools， 勾 选 其 下 面 的 两 个 选项 ， 如 图 1-9 所 示 。 


= E Sie J 2 
= Software Upd ates and Add-ons 


Installed Software Available Software | 


А Include items that 


Open the “Automatic Updates’ preference page to set up an automatic update schedule. 


@ 


图 1-8 Add Site 对 话 框 


|} software Updates and Adctons 


| lostaled Software Available Software 
type filter text " | Install. 


> [Г] A] EPP Usage Data Collector Update Site gum 
> [Е a| Ganymede Update sire a 
$ [Е] x] httpz: 1191-28, google. com/android/eclipze 
> [19] jarfile:F:tgoogle_ancroid407-0.9.4. zip! 上 sanpa 
wil jar:File: F; '\google ancradiara windosiá | = | | | 
WOU Developer Tools — — 


0.9.06, v201 002051 504-2 
0.9.6, v201 002051504-2 


I уп For Edipse 3.4, 3.5 and 3.6 
> E l The Eclipse Project Updates 


Show only the latest versionis cf available software 
Indude items that have already been installed 


1-9 4 #Developer Tools 下 面 的 两 个 选项 


6) 确认 操作 无 误 后 点 击 “Install” 按 钮 进行 安装 。 这 里 最 好 使 


默认 设置 ， 安 装 完成 后 重新 启动 Eclipse。 


1.2.4 安装 SDK 


1) Android SDK 的 官方 网 站 为 http://androidappdocs.appspot.com/sdk/， 可 以 从 该 网 站 下 载 最 新 版 的 Android SDK， 如 图 1-10 所 示 。 


Download the Android SDK 


elcome Developers! If you are new to the Android SDK, please read the Quick Start, below, tor ап 
eviev of how to install and set up the SDK. 


you are already using the Android SDK and would like to update to the latest tools or platforms, 
please use the Android SDK and AVD Manager to get the components, rather than downloading a new 


android-sdk r05- 23449838 cc2c51a24e2f876e0fa652e 182ef5840 
windows zip bytes 


android-sdk r05- 19871714 6fcfeed0a1c36624c9265516376eb3308 
mac 86zip bytes 


android-sdk_r05- 16208523 1d695d6a3131040615d49092a1bd9850 
linux 86.tgz bytes 


图 1-10 下载 Android SDK 


2) 选择 下 载 适合 Windows 平 台 开发 的 Android SDK 程 序 包 ， 文 件 名 为 android-sdk_r05-windows.zip。 下 载 完成 之 后 解压 缩 到 工作 目录 内 ， 如 F:\google_android\java_windows\。 在 SDK 目 录 内 可 
以 发 现 ，Android SDK 2.1 不 再 捆绑 platform 和 add-on 这 两 个 文件 ， 因 此 这 两 部 分 需要 手动 下 载 。 点 击 执行 SDK 目 录 里 的 SDK Setup.exe， 进 入 如 图 1-11 所 示 界 面 。 


Package Description & License 


Package Description 
~ Samples for SDK API 7, revision 1 Android SDK Platform 2,1_r1 
? Google APIs by Google Inc., Android A... Revision 1 
~ SDK Platform Android 2.0.1, АРІ 6, rev... Dependencies 
? Google APIs by Google Inc., Android A... This package depends on: 
м SDK Platform Android 2.0, APIS, revisi... ~ Android SDK Tools, revision 5 
? Google APIs by Google Inc., Android А... This package is a dependency for: 
~ SDK Platform Android 1.6, API 4, revisi,.. - Google APIs by Google Inc., Android API 7, revision 1 
? Google APIs by Google Inc., Android А... т ЕСИР 
7 Google APIs by Google Inc., Android А... Size: 77 MiB 
SDK Platform Android 1.1, API 2, revisi... SHA 1: b04453e6FOFOd0dF16740e360114cSS59092dFaf¢ = 


? Usb Driver package, revision 3 


© Accept ' Reject (O Accept All 


E ME | 


图 1-11 选择 要 安装 的 包 


3) 选择 “Accept All” 下 载 所 有 的 程序 ， 然 后 点 击 “Install” 按 钮 即 可 开始 下 载 安装 。 整 个 下 载 过程 需 要 一 定 的 时 间 ， 请 耐心 等 待 。 安 装 过 程 如 图 1-12 所 示 。 安 装 完成 之 后 ， 退 出 该 窗口 。 


4) 接 下 来 要 做 的 就 是 配置 SDK。 需 要 将 Android SDK 目 录 中 的 tools 文 件 夹 路 径 (F:\google_android\java_windows\android-sdk-windows\tools) 添加 到 台式 计算 机 的 环境 变量 Path 中 ， 具 体 配 置 
过 程 参考 JDK 环 境 配 置 的 过 程 。 


5) 重新 启动 Eclipse 之 后 ， 需 要 在 Eclipse 的 Preferences 中 添加 Android SDK 的 路 径 。 点 击 菜单 栏 中 的 “Window” 一 “Preferences”， 如 图 1-13 所 示 。 


Available Packages 
Settings Installed Packagas 


About 


Z instaling Archives 


Downloading SD& Platform Android 2.1, АРІ 7, revision L 
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S Java -Eclpse Platform х. 
File Edit Run Source Navigate Search Project Refactor 


di B? @ xe = e P- - xs New Window ge Dors dy own. 
-Ф @ = % - 5 36 Ы -bug P Jova ЕЕ 
š Open Perspective = 
[€ Package Explo 27 "I » 口 


Ë 3 Customize Perspechve... 
Seve Perspective As... 
Reset Perspective. .. 
Close Perspective 

Close Al Perspectives 


Navigacion 


Android SDK and AYD Manager 


143 Ad “Preferences” 


进入 “Preferences” 窗 口 ， 如 图 1-14 所 示 。 


6) 在 “Preferences” 窗 口 左 侧 的 目录 中 选择 “Android″” 项 ， 然 后 点 击 右 侧 的 “Browse” 按钮 ， 选 择 Android SDK 2.1 的 路 径 ， 如 图 1-15 所 示 。 


= Preferences 


Еуре Alter text 


XXX. 


Android 


- Ang 


Data Management 
Help 

Install/Lipdate 

дама 

JavaScript 

IFA, 

Plugin Development 
Remote Syeteme 
вип ейи 


— Server 


Service Policies 


— Tasks 


Team 

Usage Data Collector 
Validation 

Web 


General Чао т ср т w 


ГУ] Alas run in background 
|Kesp next/previous editor, view and perspectives dialog open 
| Show heap status 
Open made 
(& Double click 
1 Single cick 
im] Select on hover 
Bl open when using arrow keys 
Note: This preference may not take effect on all views 


Restore Defaults | | Apply | 


Cancel | 


图 1-14 KE “Preferences” 


[type fiker text 


+- General Android Preferances 


AnOrO ERR ERR ER RR ШЫ; 
Ant SDK Location: F:lgeogie. androkhijeva. vindovislandrold-edk, r3-windows!andrald-sdkadndos. Browse,, | 
I ben Management Note: The lis of SDK Targets below is опу reloaded once you hit 'Acply or 'CK", 
= P 
+ Instal/Update Terget Name Vendor 
>- Java Android 1.5 Android Open Sources Projact 
+ JavaScript Goode APIs Googe Inc. 

-— JPA &nd'ad 1.6 Android Open Sourca Projact 
i ; Goode APIs Googe Inc, 
пав Demi race 2.0 part Open So.rcs Project 
> Remote Systems 
Goode APIs Googe Inc. 
‚ Run/Debug Android 2.0.1 Android Open So.rca Projact 
Server Goode APIs Googe Inc. 
- Service Polides Android 2,1 Android Open Soroa Projact 
› Tasks Goode APIs Googe Inc, 
- Team 

Usage Data Coletor 

Validation 
Web 
^ Web Services 
-— 2Dackt 
> RML 


ч чо O08 Qn eS eww 


Standard Android platform 2.0.1 


1-15 ”选择 Android SDK 2.1 的 路 径 


添加 成 功 之 后 点 击 “Apply” 按 钮 ， 加 载 SDK 包 。 加 载 完成 后 ， 点 击 “OK” 按 钮 退出 即 可 。 


1.2.5 ”创建 Android 虚 拟 设备 


每 一 个 Android 虚 拟 设备 (Android Virtual Device, AVD) 都 模拟 了 一 套 虚 拟 设备 来 仿真 Android 平 台 ， 在 该 平台 内 至 少 有 自己 的 内 核 、 系 统 图 像 和 数据 分 区 ， 还 可 以 有 自己 的 SD 卡 和 用 户 数据 等 。 
所 以 在 执行 Android 模 拟 器 时 必须 创建 一 个 AVD 设 备 。 创 建 过 程 如 下 : 


1) 启动 Eclipse， 点 击 菜单 栏 中 的 “Window"” — “Android SDK and AVD Manager” 命 令 ， 如 图 1-16 所 示 。 


此 时 会 发 现 窗口 内 无 任何 AVD， 如 图 1-17 所 示 ， 需 要 创建 一 个 AVD。 


UM EM Ein xu Haaa SH Duel Каер HB 
Sea Se Sr: eg.) we 


P New Edit 
x em 
a рабое store 5 | Open Perspective 


BS >| | Show View 


b i= BrowsePage 
b S Cityweather 


Customize Perspective... 


b € DMA6410 TEST Save Perspective As... 
> ES DMA6410XP. TEST Reset Perspective... 

> $9 DMATEK, 6410L TEST Close Perspective 

> ES ex playservice Close All Perspectives 


> Examples 05 17 TUER 


b. 69 Examples_09_07 
> ES Examples, 12 05 Android SC D Manager 
> ЕЭ Examples_12_06 


1-16 ”选择 Android SDK and AVD Manager 


List of existing Android Virtual Devices: 


| Target Name — | Platform | API Level 
= /D available -- -- h 
Delete... 


r ` 
Repair... 


Details... 


Start... 


s А valid Android Virtual Device. 


X An Android Virtual Device that Failed to load. Click 'Details' to see the error, 


图 1-17 窗口 内 无 任何 AVD 


2) 点 击 窗口 右 侧 的 “New” 按 钮 ， 出 现 如 图 1-18 所 示 对 话 框 。 


© Built-in: Default (HvGA) ы 
O Resolution: | |х| | 


Property | маме 


Abstracted LCD density 160 


| Delete | 


加 Force create 


1-18 创建 一 个 AVD 


其 中 ，“Name” 选 项 为 创建 的 模拟 器 的 名 称 ，“Target” 为 创建 的 模拟 器 的 版 本 ，“Size” 为 SD 卡 的 容量 。 根 据 需 要 设置 这 几 个 选项 。 


3) 创建 完毕 后 点 击 “Create AVD” 按 钮 创建 一 个 名 为 sdk_2_1 的 AVD， 如 图 1-19 所 示 。 


4) AVD 创 建成 功 之 后 ， 选 中 创建 的 虚拟 设备 ， 然 后 点 击 “Start” 按 钮 ， 启 动 Android 模 拟 器 。 如 图 1-20 所 示 。 


这 样 AVD 就 创建 成 功 了 。 


f$ Android SDK and AVD Manager = | © msj] 


— = pom List of existing Android Virtual Devices: 


Avalable Packages Platform | APL Level (ымен 


eee 
м { 


B 
— — AE LL a berode шли A .A Delet 
@ | 
k... 


| Refresh | 
м A valid Android Virtual Device. 
X An Android Virtual Device that failed to load. Click ‘Details’ to see the error. 


图 1-19 创建 一 个 名 为 sdk_2_1 的 AVD 
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1-20 启动 Android 模 拟 器 


1.3 ”搭建 Linux 下 


本 节 将 主要 讲述 在 Ubuntu Linux 环 境 下 如 何 搭建 Android SDK 的 开发 环境 。 与 1.2 节 中 在 Windows 环 境 下 搭建 Android SDK 的 开发 环境 一 样 ， 在 Linux 系 统 上 开发 Android 应 用 程序 ， 需 要 安装 Linux 版 


本 的 Android SDK、Eclipse 与 JDK， 其 下 载 网 址 和 Windows 版 本 相同 ， 注 意 要 下 载 Linux 平 台 下 的 开发 版 本 。 接 下 来 详细 介绍 安装 过 程 。 


131 安装 JDK 


本 节 将 说 明 如 何 从 Oracle 公 司 的 网 站 下 载 和 安装 JDK。 具 体 步骤 如 下 : 


1) 访问 http://www.oracle.com/technetwork/java/javase/downloads/ 网 址 ， 选 择 下 载 Jlava SE 6 Update 27 版 本 ， 接 着 在 Java SE Downloads 字 段 选择 下 载 Linux 版 本 的 JDK 文 件 ， 如 jdk-6u27- 
linux-i586.bin。 


说 明 : 由 于 Android 2.1 编 译 环境 现 阶段 对 JDK 没 有 特殊 的 要 求 ， 所 以 仍然 使 用 JDK 6, 


2) 下 载 完毕 后 ， 要 使 用 管理 员 权限 执行 所 下 载 的 可 执行 文件 ， 根 据 提 示 即 可 完成 JDK 的 安装 。 


将 jdk-6u27-linux-i586.bin 文 件 先 存储 到 /home/dmatek/Android_soft 中 ， 如 图 1-21 所 示 。 


© @@ dmatek@ubuntu: ~/Android soft 


File Edit View Terminal Help 


dmatek@ubuntu:~/Android soft$ ls 

ADT-12.6.6.zip eclipse-SDK-3.7.1-linux-gtk.tar.gz 
android-sdk r13-linux x86.tar jdk-6u27-Linux-i586.bin 
dmatek@ubuntu:~/Android soft$ | 和 


1-21 先 将 文件 存储 到 Android_soft 目 录 中 


在 Linux 环 境 下 ，JDK 被 安装 到 系统 /usr/local/ 目 录 下 ， 所 以 需要 将 jdk-6u27-linux-i586.bin 文 件 放 置 到 /usr/local/ 目 录 下 进行 安装 。 使 用 管理 员 权限 把 jdk-6u27-linux-i586.bin 文 件 复制 到 /usr/local/ 
目录 下 ， 如 图 1-22 所 示 。 


© @ © dmatek@ubuntu: ~/Android soft 


File Edit View Terminal Help 


dmstek@ubuntu:~/Android softs ls 

ADT-12.0.9.zip eclipse-SDK-3.7.1-linux-gtk.tar.gz 

android-sdk r13-linux x86.tar jdk-6u27-linux-1585.bin 
dmatekgubuntu:-/Android softS sudo cp -fr jdk-6u27-linux-1586.bin /usr/local/ 
dmatek@ubuntu:~/Android softs B 


图 1-22 复制 文件 到 /usr/local 目录 下 


仍然 以 管理 员 权 限 执行 jdk-6u27-linux-i586.bin， 如 图 1-23 所 示 。 


© @@ dmatek@ubuntu: /usr/local 
File Edit View Terminal Help k 


dmatek@ubuntu:~/Android soft$ cd /usr/local/ 

dmatek@ubuntu: /usr/local$ pwd 

/usr/local 

dmatek@ubuntu: /usr/Local$ 15 

bin etc games include jdk-6u27-Linux-i586.bin lib man sbin share src 
dmatek@ubuntu:/usr/local$ sudo ./jdk-6u27-linux-i586.bin J 


1-23 ”执行 文件 


3) 安装 完毕 后 ， 必 须 修改 环境 变量 才能 使 用 JDK。JDK 的 安装 目录 在 /usr/local/jdk1.6.0_27， 此 时 需要 修改 /etc/profile 文 件 。 在 命令 窗口 输入 sudo vi/etc/profile 命 令 ， 打 开 脚 本 配置 文件 ， 然 后 加 入 
如 下 Java 的 环境 变量 ， 如 图 1-24 所 示 。 修 改 后 存储 profile 文 件 并 退出 。 


export JAVA HOME-/usr/local/jdk1.6.0 27 
export CLASSPATH-$CLASSPATH:$JAVA HOME/lib:$JAVA HOME/jre/lib 
export PATH=$PATH: $JAVA_HOME/bin:$JAVA_HOME/jre/bin: $HOME/bin 


4) 执行 如 图 1-25 所 示 的 命令 使 设 定 的 环境 变量 生效 。 


© @@ dmatek@ubuntu: /etc 
| File Edit View Terminal Help 
unset i 


-f /etc/bash.bashrc ]: then 
. /etc/bash.bashrc 


export JAVA HOME=/usr/local/jdk1.6.0 27 
export CLASSPATH= fli 
export PATH= /bin: : Bbin 
-- INSERT -- 32,58 


/jre/lib 


图 1-24 修改 profile 文 件 


© @@ dmatek@ubuntu: /etc 


File Edit View Terminal Help 


linsserv.conf udev 

insserv.conf.d ufw 

| updatedb.conf 
updatedb.conf.BeforeVMwareTcolsInstall 
update-manager 
update -motd.d 
update-notifier 

Ikernel-img.canf vin 

Ikerneloops.conf vmware-tools 

Ldap wn 

ld.soa.cache wgetre 

ld.so.conf wodim. cont 

ld.so.conf.d wpa supplicant 

legal X11 

Lftp. conf xdg 

‘Libpaper.d xml 

libuser.conf xul-ext 

locale.alias xulrunner-1.9.2 

localtime zsh_command not found 

dmatekiubuntu:/etc§$ vi profile 

ШЕ: fetc$ sudo vi profile 

[sudo] password for dmatek: 

idmatekaubuntu: fetc$ source /etc/profile 

acre TD. /etc$ 国 k 


图 1-25 ”执行 命令 使 设 定 的 环境 变量 生效 


5) 此 时 在 命令 窗口 执行 java-version 命 令 ， 若 能 检测 到 JDK 的 版 本 ， 就 说 明 JDK 已 经 安装 成 功 了 ， 如 图 1-26 所 示 。 


600 dmatek@ubuntu: /etc 
File Edit View Terminal Help 


dmatek@ubuntu: /еїс$ java -version 

java version "1.6.8 27" 

Java(TM) SE Runtime Environment (build 1.6.0 27-b87) 

Java HatSpot(TM) Client VM (build 28.2-b86, mixed mode, sharing) 
dmatek@ubuntu: /etc$ | 


1-26 ”检测 到 JDK 的 版 本 ， 表 明 安 装 成 功 


1.3.2 ”安装 Eclipse 


在 Eclipse 网 站 上 针对 不 同 程序 语言 的 开发 者 提供 了 不 同 的 开发 套件 ， 而 根据 Android 开 发 者 的 需求 ， 建 议 选择 Eclipse IDE for Java EE Developers, Eclipse IDE for Java Developers 或 Eclipse for 
RCP/Plug-in Developers 这 三 种 开发 套件 之 一 。 


本 书 使 用 的 是 Eclipse 3.7.1 版 本 ， 例 如 Eclipse 3.7.1 for Linux 版 本 (eclipse-SDK-3.7.1-linux-gtk.tar.gz) 。 执 行 下 面 的 命令 将 eclipse-SDK-3.7.1-linux-gtk.tar.gz 从 /home/dmatek/Android softEl 
录 下 复制 到 系统 /usr/local/ 目 录 下 。 


do cp -rf 
/home/dmatek/Android soft/eclipse-SDK-3.7.1-linux-gtk.tar.gz 
/usr/local/ 


接着 输入 如 下 命令 解压 缩 eclipse-SDK-3.7.1-linux-gtk.tar.gz 文 件 ， 如 图 1-27 所 示 。 


^60 dmatek@ubuntu: jusr/local 


File Edit View Terminal Help 


dmatek@ubuntu: fusrflocel$ pwd 

fusrflocal 

dmatek@ubuntu: /usr/local$ sudo cp -fr /home/dmatek/Android soft/eclipse-SDK-3.7. 
l-linux-gtk.tar.gz . 

dmatek&ubuntu:/usr/local$ Ls 

android games lih 

bin include man 
eclipse-SDK-3.7.1-linux-gtk.tar.gz  jdk1.6 k 27 sbin 

etc jdk-6&u27-limnux-i586.bin share 
dmatek&ubuntu:/usr/local$ sudo tar -zxvf eclipse-SDK-3,7.1-linux-gtk.tar.gz 


tek @ubuntu: Just... §creenshot-dmatek u... 


1-27 输入 命令 解压 缩 


$ tar -zxvf eclipse-SDK-3.7.1-linux-gtk.tar.gz 


当 解 压缩 完成 后 会 得 到 一 个 eclipse 目 录 ， 进 入 eclipse 目 录 执 行 下 面 这 个 命令 就 可 以 启动 Eclipse。 


$./eclipse 


首次 启动 Eclipse 会 出 现 提示 用 户 输入 工作 空间 路 径 的 对 话 框 ， 此 时 可 以 自行 输入 路 径 或 直接 使 


默认 的 路 径 ， 本 书 使 用 的 路 径 为 /home/dmatek/apk_workspace， 如 图 1-28 所 示 。 


此 外 ， 也 可 以 勾 选 “Use this as the default and do not ask again”， 这 样 以 后 每 次 启动 Eclipse 时 就 不 会 再 出 现 这 个 对 话 框 ， 而 是 直接 使 用 这 个 路 径 。 


当 Eclipse 顺 利 启动 后 ， 可 以 看 到 欢迎 画面 ， 如 图 1-29 所 示 。 


Workspace Launcher 


Select a workspace 


Eclipse SDK stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


Workspace: |/home/dmatek/apk lworkspace 7 | | Browse. | 


> 


Use this as the default and do not ask again 


1-28 ”输入 工作 空间 的 路 径 


Welcome to Eclipse 


Overview A Tutorials 
Get an overview of the features Mal Go through tutorials 


Samples What's New 


Try out the samples Find out what is new 


图 1-29 Eclipse 启动 后 的 欢迎 画面 


1.3.3 安装 ADT 


在 Linux 环 境 下 安装 ADT 时 ， 必 须 添加 一 个 插件 org.eclipse.wst.sse.core， 否 则 安装 过 程 会 报错 。 下 载 插件 org.eclipse.wst.sse.core 的 网 址 为 http://download.eclipse.org/releases/ganymede/。 所 以 
需要 先 安装 org.eclipse.wst.sse.core 插 件 ， 这 个 插件 安装 成 功 后 再 安装 ADT (Android Development Tools) 。 下 面 是 进行 org.eclipse.wst.sse.core 插 件 以 及 ADT 的 安装 步骤 。 


1) 点 击 Eclipse 菜单 栏 中 的 “Help” 一 “install new software”， 出 现 如 图 1-30 所 示 界 面 。 


Available Software 
Select a site or enter the location of a site. 


2 


Find more software by working with the “Available Software Sites" preferences. 


type Hiter text d 


7 @ There is no site selected. 


图 1-30 ”安装 插件 


2) mh "Add" 按钮 添加 org.eclipse.wst.sse.core 播 件 ， 如 图 1-31 所 示 。 


3) 在 “Location” 文 本 框 中 添加 网 址 http://download.eclipse.org/releases/ganymede/， 如 图 1-32 所 示 。 


Add Repository 


图 1-31 添加 org.eclipse.wst.sse.core 插 件 


Add Repository 


Location: | http://download.eclipse.org/releases/ganymede/ | Archive.. | 


9$ а 


图 1-32 ”下 载 org.eclipse.wst.sse.core 插 件 


4) 点 击 “OK” 按 钮 退出 。 几 分 钟 之 后 ， 在 Name 中 会 列 出 相应 的 安装 列表 ， 如 图 1-33 所 示 。 


Work with: | http://download.eclipse.org/releases/ganymede/ w Add. | 


Find more software by working with the "Available Software Sites" preferences. 


type filter text d 


iüü Charting and Reporting 


100 Collaboration Tools 
шй Communications 
100 Database Development 


图 1-33 ”安装 列表 
选择 列表 中 的 最 后 一 项 “Web，XML，Java EE and OSG: Enterprise Development”， 然 后 点 击 “Next” 按钮 进行 安装 和 更 新 。 待 org.eclipse.wst.sse.core 插 件 安装 完成 后 继续 下 一 步 。 


5) 点 击 菜单 栏 中 的 “Help” 一 “install new software” 命 令 ， 弹 出 “Add Repository” 对 话 框 ， 点 击 “add” 按钮 添加 ADT 插 件 ， 如 图 1-34 所 示 。 


Ada Site 


图 1-34 ЖААРТ 
由 于 已 经 得 到 了 ADT 的 压缩 文件 ， 所 以 直接 点 击 “Archive” 按 钮 添加 即 可 。 


6) max "OK" 按钮 完成 添加 。 如 图 1-35 所 示 。 


type filter text 


109 Developer Tools 


图 1-35 “完成 添加 


7) At "Select All" 按钮 ， 选 择 Name 下 所 有 的 安装 列表 ， 如 图 1-36 所 示 。 


= @ 99 Developer Tools 
@ P Android DDMS 
& 4» Android Development Tools 


& 4 Android Hierarchy Viewer 


= r= 


uncle oe Po т 


1-36 ”点击 “Aelect All” 按 钮 


完成 选择 之 后 ， 点 击 “Next” 按 钮 ， 进 行 下 一 步 安 装 ， 如 图 1-37 所 示 。 


8) 点 击 “Next” 按 钮 ， 继 续 安 装 ， 点 击 “| accept the terms of the license agreements”， 如 图 1-38 所 示 。 


点 击 “Finish” 按 钮 开始 安装 ， 如 图 1-39 所 示 。 


Install Details 
Review the items to be installed. 


@ Android DDMS 

Q Android Development Tools 
i$» Android Hierarchy Viewer 
G> Android Traceview 


Size: Unknown 
Details 


图 1-37 安装 进程 中 


Review Licenses 
Licenses must be reviewed and accepted before the software can be 


installed. 
Licenses: License text: 


Ca A Pache License 
| Version 2.0, January 2 


+ Note: jcommon-1.0.12.jar is under the BSC hitp-Jjwww.apache огу 
+ Note: kxml2-2.3.0.jar is under the BSD lice 


@ | accept the terms of the license a 
^ | do not accept the terms of the li 


> 


| o 


图 1-38 ”选择 同意 版 权 声明 


Installing Software 


o Installing Software 


Always run in background 


1-39 ”开始 安装 


安装 过 程 需要 一 定时 间 ， 请 耐心 等 待 。 安 装 过 程 中 会 出 现 如 图 1-40 所 示 窗 口 。 


9) 点 击 “OK” 按 钮 继续 安装 。 安 装 完成 之 后 ， 系 统 会 提示 重新 启动 Eclipse， 如 图 1-41 所 示 。 


点 击 “Restart Now” 重 新 启动 Eclipse。 至 此 完成 了 ADT 插 件 的 安装 。 


security Warning 


Waming: You are installing software that contains unsigned content. The 
authenticity or validity of this software cannot be established. Do you want to 


continue with the installation? 


图 1-40 点击 “OK” 按 钮 继续 安装 


Software Updates 


You will need to restart Eclipse SDK for the installation changes to take effect. 
< You may try to apply the changes without restarting, but this may cause errors. 


图 1-41 安装 完成 重新 启动 Eclipse 


1.3.4 安装 SDK 


首先 从 Android 开 发 网 站 (http://developer.android.com/sdk/index.html) 下 载 Linux (1386) 环境 所 需 的 SDK 压 缩 文件 android-sdk_r13-linux_x86.tar， 如 图 1-42 所 示 。 


android-sdk_113-windows zip 36487911 bytes de&a039891e5e65b77427188f07b992d 


installer r13-windows.exe (Recommended) 36533357 bytes cdja/6fe2b8ed62b2d03cf1851692e2d 


Mac OS X (intel) android-sdk r13-mac x86 zip 30233944 bytes f400220344b48856c09dec796acecd4d 


Linux (1386) android-sdk r13-inux x86 tgz 30034328 bytes d8(0d/530a46c665644ae/6084a9a0dc4 


图 1-42 下载 SDK 压 缩 文 件 
SDK 压 缩 包 文件 下 载 完 成 后 ， 开 始 在 Linux 环 境 下 安装 Android SDK， 其 安装 过 程 如 下 : 


1) 在 Linux 环 境 下 ， 把 SDK 安 装 到 系统 的 /usr/local/android 目 录 中 。 把 android-sdk_r13-linux_x86.tar 文 件 复制 到 系统 的 /usr/local/android 目 录 下 ， 操 作 命 令 如 下 : 


$cd /usr/local/android 
$sudo cp -r 
/home/dmatek/Android soft/android-sdk r13-linux x86.tar ./ 


注意 : 如 果 在 /usr/local 目 录 下 没有 android 目 录 ， 那 么 可 以 使 用 mkdit 命 令 创建 一 个 android 目 录 ， 命令 如 下 : 


$cd /usr/local/ 
$sudo mkdir -p android 


2) 使 用 如 下 命令 解压 缩 android-sdk_r13-linux_x86.tar 文 件 ， 如 图 1-43 所 示 。 


Star -xvf android-sdk r13-linux x86.tar 


解压 缩 成 功 后 ， 在 /usr/local/android 目 录 下 生成 一 个 android-sdk-linux_x86 目 录 文件 ， 此 文件 为 SDK 安 装 程序 文件 。 


з) 设置 系统 环境 变量 。 设 置 SDK 的 安装 目录 为 SDK}， 例 如 /usr/local/android/androidsdk-linux_x86， 接 着 将 ${SDK}/tools 加 入 系统 Path 环 境 变量 中 。 修 改 方法 如 下 : 使 用 命令 sudo vi/etc/profile 
打开 系统 profile 文 件 ， 将 ${SDK}/tools 的 路 径 加 入 Path。 使 用 source/etc/profile 命 令 使 其 生效 ， 如 图 1-44 所 示 。 命 令 如 下 所 示 : 


export SDK=/usr/local/android/android-sdk-linux x86 
export PATH=$PATH:$SDK/tools 


© © Ф dmatek@ubuntu: /usr/local/android 


File Edit View Terminal Help 


dmatekgubuntu:/usr/local/android$ pwd 

/usr/local/android 

dmatek@ubuntu:/usr/Local/android$ sudo cp -fr /home/dmatek/Android soft/android- 
sdk r13-linux x86.tar 

dmatek(ubuntu:/usr/Local/android$ ls 

android-sdk ri3-linux x85.tar 

dmatek@ubuntu:/usr/Local/android$ sudo tar -xvf android-sdk r13-linux x86.tar B 


ek@ubuntu: AusrA... ©] dmatek@ubuntu: /etc Screenshot-dmatek@u... 


图 1-43 ”解压 缩 文件 


QG dmatekgubuntu: /etc 
File Edit View Terminal Help 


f /etc/bash.bashrc ]: the 
yetc/bash.hbashrc 


144 设置 系统 环境 变量 


4) 和 Windows 平 台 一 样 ， 在 Linux 平 台 下 Android SDK 也 不 再 捆绑 platform 和 add-on 这 两 个 文件 ， 因 此 这 两 部 分 需要 手动 下 载 。 打 开 命 令 窗口 ， 进 入 android-sdk-linux_86 文 件 的 Tools 目 录 下 ， 启 动 
Android SDK and AVD Manager， 如 图 1-45 所 示 。 


执行 ./android 命 令 后 ， 会 看 到 如 图 1-46 所 示 窗 口 。 


QOGQ dmatek@ubuntu: /usr/local/jdk1.6.0 27/bin 
File Edit View Terminal Help 


dmatek@ubuntu: /usr/local/android/android-sdk-linux x86$ pwd 
/usr/local/android/android-sdk-linux x86 

dmatek@ubuntu: /usr/local/android/android-sdk-linux x86$ cd tools/ 
dmatek@ubuntu: /usr/local/android/android-sdk-linux x86/tools$ 15 

adb has moved.txt dmtracedump etcltool mksdcard sqlite3 
android draw9patch hierarchyviewer  monkeyrunner traceview 


ant emulator hprof-conv NOTICE. txt zipalign 
apkbuilder emulator-arm  layoutopt proguard 

ddms emulator-x86 Lib source.properties 
dmatek@ubuntu: /usr/local/android/android-sdk-linux x86/tools® sudo ./android 


1-45 #Android SDK and AVD Manager 


Virtual devices List of existing Android Virtual Devices located at /horne/ach/.android/avd 
Installed packages || sum Name | | 

Available packages __ Мо AWD available | -- 

Settings 

About 


v A valid Android Virtual Device. Б A repairable Android Virtual Device. 
с An Android Virtual Device that failed to load. Click 'Details' to see the error 


图 1-46 ”执行 ./android 命 令 后 的 窗口 


5) mah "Installed packages” 选 项 ， 进 入 如 图 1-47 所 示 窗 口 。 


Virtual devices 


K Android SDK Too 


Avalla ble PETEN 
Settings 
About 


图 


同 Windows 平 台 下 一 样 ， 需 要 下 载 相关 的 程序 包 ， 点 击 “Update All ”按钮 ， 如 


首先 选择 “Accept All” 


Choose Packages to Install 


Documentation for Android SDK, AH - | 
v SDK Platform Android 3.2, API 13, пі 
~ SDK Platform Android 3.1, API 12, n 

wv SDK Platform Android 3.0, API 11, n 

> SDK Platform Android 2.3.3, API 10, 

wv SDK Platform Android 2.3.1, АРІ 9, | 

~ SDK Platform Android 2.2, API 8, re Б 


— тъй 大 ^ simm am тт. 


] Something depends on this package 


单 选 按钮 ， 然 后 再 点 击 “Install” 按 钮 开始 在 线 下 载 安装 。 如 图 


SDK Location: fusrlocal/android/android-sdk-linux_»B6 


15, revision 13 


1-47 “Installed packages" ЖД А 2 


图 


1-48 所 示 。 


1-49 所 示 ， 这 个 过 程 需要 很 长 一 段 时 间 ， 请 耐心 等 待 。 等 到 SDK 在 线 下 载 安装 完成 就 可 以 了 。 


Package Description & License 


Package Description 
Android SDK Platform-tools, revision 7 


Dependencies 
This package is a dependency for: 
- Android SDK Tools, revision 13 


Archive Description 
Archive for Linux 


7 Accept © Reject 


1-48 ”下 载 相关 程序 包 


installing Archive® 


Downloading Documentation for Android SDK, АРІ 13, revision 1 (' 
mm 
Downloading Android SDK Platform-tools, revision 7 * 


Installing Android SDK Platform-tools, revision 7 
'adb kill-server' failed -- run manually if necessary. 


Installed Android SDK Platform-tools, revision 7 
Downloading Documentation for Android SDK, API 13, revision 
1 


图 1-49 在 线 下 载 安装 
1.3.5 ”创建 Android 虚 拟 设备 


在 1.3.4 节 SDK 下 载 完 成 后 ， 开 始 创建 AVD。 与 Windows 平 台 下 步 又 一 样 ， 启 动 Eclipse 后 ， 进 入 “Android SDK and AVD manager” 窗 口 
所 示 界面 ， 创 建 一 个 基于 Android 2.1 的 AVD， 名 称 为 “sdk 2 1" , 


， 依 次 点 击 “Virtual Devices” 一 “New”， 进 入 如 图 1-50 


如 图 1-50 所 示 , 在 “Name”、 "Target" , SD Card 中 的 “Size” 和 “Skin” 栏 


中 填写 相应 的 内 容 后 ， 点 击 “Create AVD” 按 钮 进行 创建 。AVD 创 建成 功 将 出 现 如 图 1-51 所 示 窗 口 。 


Create new AVD 


Android 2.1 - API Level 7 


v | 
^ File: | | Brow se. | 


& Built-in: | Default (HVGA) 


^j Resolution: 


Create AVD || Cancel | 


Android SDK and AVD Manager 


Virtual Devices List of existing Android Virtual Devices: 


Installed Packages || AVD Name Target Name Platform API Level || New... | 


Available Packages v sdk 21 Android 2.1 2.1 7 
a | Delete... | 


About | 


| Details... | 


| Start... | 


| Refresh | 


v A valid Android Virtual Device. 
( An Android Virtual Device that failed to load. Click 'Details' to see the error. 


1-51 AVD 创 建成 功 


点 击 “Start” 按 钮 ， 可 以 启动 模拟 器 ， 启 动 成 功 后 出 现 如 图 1-52 所 示 窗口 。 


5554:sdk 2 1 


Messaging 


rera m3 mers pp manapi 


Vad "Е 2 rm p РТ saa pos pan pi asnay psum pus puer pan 


/ А 
Рһопе Contacts Browser 


ALT | P | ALT 


图 1-52 ”模拟 器 启动 成 功 


接 下 来 需要 向 Eclipse 的 Preferences 中 添加 Android SDK 的 路 径 。 重 新 启动 Eclipse， 依 次 点 击 菜单 栏 中 的 “Window” 一 “Preferences” 命 令 ， 如 图 1-53 所 示 。 


Java - Eclipse SDK 


Refactor Run N 


Fi Java 


E PackageE Ж | Show View - D B= Out >: 


Customize Perspective [Ап outline is not 
lavailable. 


1 Perspectives 


| Problems ?$ @ Javadoc [® Declaration | 


0 items 


图 1-53 i&4f “Preferences” 


进入 “Preferences” 对 话 框 后 点 击 左 侧 “Android” 标 签 ， 添 加 Android SDK 的 路 径 ， 如 图 1-54 所 示 ， 点 击 “Browse” 按钮 添加 Android SDK 目 录 所 在 的 路 径 。 


Preferences 


type filter text 4 Android 


Android Preferences 


SDK Location: Jusr/local/android/android-sdk-linux_x86 | linux Jusr/local/android/android-sdk-linux_x86 | , Browse. - 


Help Note: The list of SDK Targets below is only reloaded once you hit 'Apply' or ‘OK’. 
Install/Update В ^ 
Plug-in Development Google APIs Google Inc. 
Run/Debug Android 3.0 Android Open Source Project 
Team Google APIs Google Inc. 
XML Android 3.1 Android Open Source Project 

Google APIs Google Inc. 

Google TV Addon Google Inc. 


Google TV Addon Google Inc. 
Google TV Addon Google Inc. 


Android 3.2 Android Open Source Project 13 


* 
* 
出 
出 
+ 
+ 
+ 
+ 


1-54 添加 Android SDK $4 34 


如 图 1-54 所 示 ， 在 “SDK Location” 文 本 框 中 添加 Android SDK 的 路 径 ， 然 后 点 击 “Apply” 按 钮 进行 加 载 。 最 后 点 击 “OK” 按 钮 退出 对 话 框 。 


创建 一 个 Android 工 程 ， 测 试 环境 是 否 搭建 成 功 。Linux 平 台 下 Android 工 程 的 创建 过 程 和 Windows 平 台 下 的 相同 ， 此 处 不 再 歼 述 。 


14 搭建 NDK 开 发 环境 
本 节 将 详细 介绍 如 何在 Windows 以 及 Linux 系 统 中 搭建 Android NDK 开 发 环境 。 


141 NDK 开 发 环境 与 安装 目录 


Android NDK 开 发 环境 使 用 的 软件 如 图 1-55 所 示 。 


Windows 


android-ndk-r6b-linux- 


android-ndk-r6b-windows.zip x86.tar.tar 


cygwin 1.7.8.rar Aviti E 


图 1-55 Android NDK 开 发 环境 所 使 用 的 软件 


本 书 中 NDK 开 发 环境 中 软件 的 安装 目录 如 图 1-56 所 示 。 


C:\cygwin\usr\local\android\ \usr\local\android\android- 


android-ndk-r6b ndk-r6b 


C:\cygwin 


图 1-56 Android NDK 开 发 环境 中 软件 的 安装 目录 


142 ”系统 和 软件 需求 
首先 了 解 所 需要 的 系统 及 软件 要 求 。Google 公 司 官方 推荐 的 系统 及 软件 要 求 如 下 。 
- SDK: 要 求 Android SDK 1.5 或 1.5 以 上 版 本 ， 本 书 使 用 2.1 版 本 。 


“МОК: 要 求 NDK R3 或 R3 以 上 版 本 ， 本 书 使 用 R6B 版 本 。 


NDK 开 发 既 支 持 Windows 平 台 ， 也 支持 Linux 平 台 ， 只 需 下 载 相应 平台 的 开发 软件 即 可 。 下 面 将 具体 介绍 Windows 和 Linux 平 台 下 NDK 环 境 的 搭建 过 程 。 


NDK R6B 版 本 的 下 载 地 址 为 http://developer.android.com/sdk/ndk/index.html， 如 图 1-57 所 示 。 
+ Windows 平 台 下 NDK 文 件 名 为 android-ndk-r6b-windows.zip。 


` Linux 平台 下 NDK 文 件 名 为 android-ndk-r6b-linux-x86.tar.bz2。 
Platform Package MD5 Checksum 

Windows android-ndk-r6b-windows zip 67670219 bytes f496b48f1f56d34 1303de1703081b812 
Mac OS X (intel) android-ndk-r6b-darwin-x86 tar.bz2 52798843 bytes | 6512589ac1b08aabe3183f9ed1a8ce86e 


Linux 32/64-bit (x86) android-ndk-rGb-linux-x86 tar.bz2 46532436 bytes 309f35e49b64313cfb20ac428df4cec2 


1-57 МОК R6B 版 本 列表 


143 ”Windows 平 台 NDK 环 境 搭建 


1. 安 装 Cygwin 


1) 因为 NDK 编 译 需要 用 到 Cygwin 中 的 make 和 gcc， 所 以 需要 下 载 安装 Cygwin 软 件 。 访 问 www.cygwin.com 网 站 ， 如 图 1-58 所 示 。 


Installing and Updating Cygwin 


Run setup.exe any time you want to update or install a Cygwin package. The signature for setup.exe can be used to 
verify the validity of this binary using this public key. 


When installing packages for the first time, setup.exe does nor install every package. Only the minimal base 


packages from the Cygwin distribution are installed by default. Clicking on categories and packages in the 
setup.exe package installation screen will provide you with the ability to control what ts installed or updated. 
Clicking on the "Default" field next to the "All" category will provide you with the opportunity to install every Cygwin 
package. Be advised that this will download and install hundreds of megabytes to your computer. The best plan is 
probably to click on individual categories and install either entire categories or packages from the categories 
themselves. 


图 1-58 ”访问 Cygwin 网 站 


点 击 setup.exe 超 链接 ， 下 载 Cygwin。 


2) 下 载 完成 后 ， 双 击 下 载 的 setup.exe 安 装 程序 ， 进 入 安装 界面 ， 如 图 1-59 所 示 。 


3) 点 击 图 1-59 中 的 “下 一 步 ”按钮 ， 进 入 图 1-60 所 示 界 面 。 


Cygwin Setup 


Cygwin Net Release Setup Program 


This setup program is used for the initial installation of the 
Cygwin environment as well as all subsequent updates. Make 
sure to remember where you saved it. 


The pages that follow will guide you through the installation. 
Please note that Cygwin consists of a large number of 
packages spanning a wide variety of purposes. We only 
install a base set of packages by default. You can always run 
this program at any time in the future to add, remove, or 
upgrade packages as necessary. 


С 
Setup exe version 2 738 
Copyright 2000-2010 


1-59 ”安装 Cygwin 


Cygwin Setup 一 Choose Installation Type 


Choose A Download Source 
Choose whether to install or download from the intemet. or install from files in 
a local directory. 


© Install from Intemet 
(downloaded files will be kept for future re-use) 


© Download Without Installing 


取消 


81-60 选择 安装 方式 


注意 : 图 1-60 中 的 三 个 选项 分 别 代表 三 种 安装 方式 ， 第 一 项 “Install from Internet” 是 在 没有 本 地 安装 程序 包 的 情况 下 ， 通 过 网 络 在 线 安装 ， 所 以 必须 有 网 络 的 支持 ; 第 二 项 “Download Without 
Installing” 是 通过 网 络 直接 下 载 安装 程序 包 ， 但 是 不 进行 安装 过 程 ， 这 项 也 需要 网 络 的 支持 ; 第 三 项 “Install from Local Directory” 是 直接 通过 本 地 安装 程序 包 进 行 安装 ， 所 以 在 安装 前 先 要 通过 第 二 项 
下 载 好 安装 程序 包 。 


由 于 安装 程序 包 比较 大 ， 安 装 过 程 较 长 ， 所 以 最 好 采用 第 二 种 和 第 三 种 结合 的 方式 ， 先 下 载 ， 后 安装 。 本 书 中 使 用 第 三 项 ， 先 下 载 好 安装 程序 包 ， 然 后 进行 安装 。 


4) 下 载 Cygwin 的 完整 安装 程序 包 ， 然 后 进行 安装 ， 点 击 图 1-60 中 的 “下 一 步 ”按钮 ， 进 入 图 1-61 所 示 界 面 。 


Cygwin Setup — Choose Installation Directory aay 


Select the directory where you want to install Cygwin. Also choose a few 


Select Root Install Directory c 
installation parameters. 


Root Directory 


Install For 


(®) All Users (RECOMMENDED) 
Cygwin will be available to all users of the system. 


© Just Me 


Cygwin will still be available to all users, but Desktop Icons, Cygwin Menu Entries, and 
important Installer information are only available to the current user. Only select this ff 
you lack Administrator privileges or if you have specific needs. 


图 1-61 选择 安装 目录 
5) 设置 “Root Directory” 为 “C:Ncygwin”， 点 击 “ 下 一 步 ”按钮 ， 进 入 图 1-62 所 示 界 面 。 
注意 : 本 书 将 下 载 的 安装 程序 包 放置 在 D:\Android_soft 目 录 下 ， 可 以 把 安装 程序 包 解压 缩 到 任意 目录 下 进行 安装 。 


6) 设置 “Local Package Directory" 后， 点 击 “ 下 一 步 ”按钮 ， 进 入 图 1-63 所 示 界 面 。 


Cygwin Setup - Select Local Package Directory Е Jx) 


Select Local Package Directory 
Select a directory where Setup should look for downloaded installation files. C 


Local Package Directory 
D-MAndroid. softcygwin http Ba %2f %2fmimors Кете! ога% 2fsourceware 7; 2f 


1-62 ”选择 安装 程序 包 的 解压 目录 


Cygwin Setup 一 Select Packages 


Select Packages 
Select packages to install 


Sexh| | (Gear) O keep OPrev @©Gur Op 


Accessibility 4% Default 
E] Admin £f Default 
Archive 4¥ Default 
[Н Audio 4¥ Default 
Base 4¥ Default 
9 Database 4¥ Default 
B] Devel 必 Install 
E] Doc &* Default 
< Eom 


[v] Hide obsolete packages 


1-63 选择 安装 程序 包 


7) 根据 需要 设置 后 点 击 “ 下 一 步 ”按钮 ， 开 始 下 载 安装 过 程 ， 如 图 1-64 所 示 。 


8) 下 载 完成 后 ， 点 击 “ 下 一 步 ”安装 ， 进 入 图 1-65 所 示 界 面 。 


注意 : NDK 需 要 的 make 和 gcc 在 该 节点 下 ， 点 击 箭头 所 指 的 循环 箭头 图 示 ， 将 Default 状 态 切 换 成 Install 状 态 。 


9) 点 击 “ 下 一 步 ” 按 钮 进入 安装 状态 ， 如 图 1-66 和 图 1-67 所 示 。 


Cygwin Setup 


Progress 
This page displays the progress of the download or installation. 


Downloading... 
setup.bz2 from http: //cyqwin.lilengine.com/ 
25 % (61k/240k) 7.5 kB/s 


Progress: ъюе— — | 


1-64 ”下载 安 装 过 程 


С: Cygwin Setup - Select Packages | со | (2) = 


Select Packages 
Select packages to install 


| Category — | Current | Wew |B | S. | Size | Package | 


Ej А11 & Default 
Archive £f Default 
Base £f Default 


8 Database & Default 
[E Devel & install) 注意 切换 为 Install 状态 
В Doc &* Default 


Editors 4¥ Default 
E Gnome 4% Default 


Hide obsolete and administrative packages 


图 1-65 ”将 Default 状 态 切换 成 Install 状 态 


Cygwin Setup — Resolving Dependencies 


Progress 
This page displays the progress of the download or installation. 


Checking prerequisites... 
libxcb-render-utilÜ 
196 % (640/326) 


图 1-66 MERKE 


Cygwin Setup 


Progress 
This page displays the progress of the download or installation. 


Checking MDS for clisp-2.48-3 


Progress: 
Total: 
Disk: 


1-67 安装 进程 


10) 安装 成 功 后 ， 运 行 Cygwin 程 序 ， 如 图 1-68 所 示 。 


11) 输入 命令 检查 make 和 gcc 是 否 安装 成 功 ， 如 图 1-69 所 示 。 


wpying skeleton files. 
These files are for the user to personalise 
their cygwin experience. 


These vill never be overwritten. 


` / bashre’ > *“Shome/fAdnministrators,s.hbashre’ 


‘./.bash_profile’ -> ‘/home/Administrator//.bash 


"oo inputrc * > '^hone^Rdninistratorz^/,inputrc* 


图 1-68 运行 Cygwin 


Copyright <C> 2886 Frec Software Foundation, Inc. 

This is free software; see the source for copying conditions - 

There is NO warranty; not сусп for MERCHANTABILITY or FITNESS FOR fi 
PARTICULAR PURPOSE. 


Ihis program built For 1686-—pce-cyquin 


5 gcc -u 
Using built-in specs. 
Target: i686-pc-cygwin 
Configured with: /gnu^qgcc^roleases/roespins/4.3.4—-4^/9gcc4-4.3.4-4^2rc/9gcc-1.3.4^co 
nf igupe ——srcdir-/gnu/z/qgcc/releases/respins/4.3.4-4/gcc4-4.3.4-4^7sPrc/gcc-4.3.4 一 一 
prefix-/ucr ——exec-prefix-/uzr» —hindir=/ucr/bin --sbindir-/usr^/sbin --libexecdi 
r-/usr^lib datadir-/usr/sharc localstatcdir-/var susconfdir-/^/ctc infodir 
-/usrzsharezZ/info ——-manmdir-/usr/share/man -C ——datadir-/usrz/share --infodir-/usr^/ 
chamerzinfo ——-mandir=/ucr/share/sman -u ——with-ymp-/ue» —with—-npfr=/usyr ——enable- 
bootstrap cnablc-vcrsion-spccific-runtimc-libs vith-slibdir-^/usr^hin libex 
Pcdir-/usr^/lih —-enable-static —-enable-shared —--enahle-shared-libgcc 一 -Qisable 一 
сха atcxit vith-gnu-1ld vith-gnu-oas vith-dvarf2 disablc-5jlj-cexccptions 
-——-enahle-languages-ada.c.ct*t*.fortran.jaua.0hjc.obj-c** ——-disahle-symuers —-—-enah 
le-libjava --program-euffix--4 ——enable-libgomp --enable-lihbssp --enable-libada 
cnahblc-thrcads-posix vith-arch-i686 vith-tunc-gencric cnablc-libgcj-subl 
ibs GG-gcc-4 СКИ =д++—-4 СС FOR TARGET-gcc—4 САК FOR TRRGET-9g**—-4 GNATMAKE FOR ТАк 
GET-gnatnake GNATBIND_FOR_TARCET=gnathind --vith-ecj-jar-/usr^share/java^ecj. jar 


Thread nodel: posix 


gcc version 4.3.4 28878884 <release)> 1 (GCC) 


a 
? 


图 1-69 检查 安装 是 否 成 功 


若 出 现 图 1-69 所 示 信 息 ， 则 说 明 安装 成 功 。 


2 环境 参数 的 设置 


Т) 将 下 载 的 NDK 压 缩 包 解压 到 工作 目录 ， 本 书 将 Cygwin 安 装 在 C:\cygwin 目 录 下 ， 如 图 1-70 所 示 ; Android NDK 解 压 后 的 工作 路 径 为 C:\cygwin\usr\local\android\android-ndk-r6b 目 录 ， 如 图 1- 
71 所 示 。 


EF C-icyrwin 


TAG) RBT 查看 如 ”收藏 如 IAW #80) 


Qa- O- 12 Pre Бн nri "S 


vey  Ё 


eyzdriva 
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< SYSTEM (C2 
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1-70 Cygwin Ж AC:\cygwin A RF 


Es C-XcymwinXuzrilocalXandroid 
EIR) BE) Bee) ША) ТАШ) FAW 


其 它 位 置 


ica local 
MET 


EET 
g 我 的 电脑 
G РЕНЕ 


1-71 将 NDK 压 缩 包 解压 到 工作 目录 


2) 为 了 修改 环境 变量 ， 先 执行 安装 好 的 Cygwin 软 件 ， 点 击 桌 面 上 的 Cygwin 图 标 进行 文件 复制 ， 如 图 1-72 所 示 ， 成 功 执行 之 后 关闭 窗口 。 


注意 : 这 一 步 很 重要 ， 否 则 看 不 到 下 一 步 中 的 文件 。 


3) 修改 C:\cygwin\home\Administrator 目 录 下 的 .bash_profile 文 件 ， 添 加 以 下 内 容 ， 如 图 1-73 所 示 。 


PATH-/usr/local/android/android-ndk-r6b:$PATH 
NDK ROOT-/usrl/local/android/android-ndk-r6b 
NDK Sample-/cygdrive/c/apk workspace 


Copying skeleton files. 
These files are for the users to personalise their cygwin experience. 


They will never be overwritten nor automatically updated. 


`. bashrc’? -> '/home/füdministrator//.bashrc' 

./.bash profile' -> `/home/Administrator//.bash_profile’ 
"./.inputrc' —> "/home/Rdministrator//.inputrc' 

` .Z.profile' 一 > ‘/home/Administrator//.profile’ 


ie 


1-72 文件 复制 
= C:\cygwin\hone\Administrator (= 


Qe © -AP E MERO | 


地 址 Ф) СЫ C: \eygwin\home\Administrator 


[bash profile | ‚ bashre 
ВАН PROFILE Xf BASHRC X 
.inputre profile 
INPITRC VË PROFILE Wi 
> XR і KP 


8.94 KB 


电 我 的 电脑 


图 1-73 ”修改 .bash_profile 文 件 


其 中 ，NDK_Sample 所 指 的 目录 是 Eclipse 的 Workspace 目 录 ， 如 Ci\apk_workspace， 若 在 Cygwin 终 端 里 使 


， 则 路 径 就 表示 为 /cygdrive/c/apk_workspace。 


注意 : 修改 .bash_profile 文 件 时 请 不 要 使 


记事 本 处 理 ， 否 则 将 会 出 现 乱 码 。 


4) 点 击 Cygwin 执 行程 序 ， 并 进入 NDK 程 序 包 目录 ， 如 图 1-74 所 示 。 


= /cygdrive/c/cygwin/usr/local/android/android... -of x] 


feygdrive/c/cygwin/usr/local/androic 
$ cd G: — 


cd cygvin/usr/local/android/android-ndk-r6b^/ 


© пой 


ycuygdriue/c/cyquin/usr/local/android/android-ndk-r6bh 
$ 


1-74 进入 NKD 程 序 包 目 录 


5) 为 了 验证 NDK 开 发 环境 是 否 搭建 成 功 ， 可 以 对 android-ndk-r6b\samples\ 目 录 下 的 hello-jni 程 序 进行 编译 ， 查 看 是 否 可 以 得 到 SO 文件 ， 操 作 命 令 如 图 1-75 所 示 。 


© cd samnples/hello—jni/ 


у} amp 1t ell 

$ ndk-build 

Gdbserver [arm-linux-androideabi-4.4.31 libs/armeabi/gd 
Gdbsetup libs/armeabi/gdb.setup 

Compile thumb hello-jni <= hello-jni.c 

SharedLibrary libhello-jni.so 

Install libhello-jni.so => libs/armeabi/libhello-jni. 


jq uin! 


图 1-75 NDK 的 开发 环境 搭建 成 功 


$cd samples/hello-jni 
$ndk-build 


看 到 如 图 1-75 所 示 编 译 结果 ， 表 示 NDK 的 开发 环境 搭建 成 功 。 至 此 ， 在 Windows 平 台 下 成 功 搭建 了 NDK 的 开发 环境 。 


相 比较 Windows 系 统 ，Linux 平 台 自 身 具 有 调试 编译 功能 。 在 Linux 系 统 终端 下 可 直接 搭建 NDK 的 开发 环境 。 具 体 步骤 如 下 : 


1) 先 检 测 一 下 Linux 系 统 make 和 gcc 工 具 的 版 本 ， 打 开 Linux 系 统 终端 ， 依 次 执行 命令 : make-v，gcc-v， 如 图 1-76 所 示 。 


6060 dmatek@ubuntu: ~ 


File Edit View Terminal Help 


dmatekQubuntu:-$ make -v 

GNU Make 3.81 

Copyright (C) 2606 Free Software Foundation, Inc. 

This is free software; see the source for copying conditions. 

There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A 
PARTICULAR PURPOSE. 


This program built for i486-pc-linux-gnu 
dmatek@ubuntu:~$ gcc -v 
Using built-in specs. 


Target: 1486-1 іпих -дпи 

Configured with: ../src/configure -v --with-pkgversion='Ubuntu M .4.3-4ubuntu5' 
-with-bugurl=file:///usr/share/doc/gcc-4.4/README.Bugs --enable-lLanguages=c,c++, 
fortran,objc,obj-c++ --prefix=/usr --enable-shared --enable-multiarch --enable-l 
inker-build-id --with-system-zlib --libexecdir-/usr/lib --without-included-gette 
xt --enable-threads-posix --with-gxx-include-dir=/usr/include/c++/4.4 --program- 
suffix--4.4 --enable-nls --enable-clocale-gnu --enable-libstdcxx-debug --enable- 
plugin --enable-objc-gc --enable-targets-all --disable-werror --with-arch-32=148 
6 --with-tune-generic --enable-checking-release --build-i486-linux-gnu --host-i4 
86-linux-gnu --target-i486-linux-gnu 

Thread model: posix 

gcc version 4.4.3 (Ubuntu 4.4.3-4ubuntu5) 

dmatek@ubuntu:~$ 


图 1-76 ”检测 Linux 系 统 中 make 和 gcc 工 具 的 版 本 


2) 把 Linux 下 的 NDK 安 装 程序 包 复制 到 当前 用 户 (本 书 使 用 的 用 户 名 为 dmatek) 的 Android_soft 目 录 下 ， 如 图 1-77 所 示 。 


3) NDK 在 Linux 下 的 安装 路 径 为 /usr/local/android， 执 行 如 下 命令 ,把 NDK 包 解压 缩 ， 如 图 1-78 所 示 。 


$cd/home/dmatek/Android soft 
tar -xvf android-ndk-réb-linux-x86.tar.tar 


© @ @ dmatek@ubuntu: ~/Android_ soft 


File Edit View Terminal Help 


dmatek@ubuntu:~/Android soft$ pwd 
/home/dmatek/Android soft 


dmatek@ubuntu:~/Android soft$ ls 
ADT-12.6.6.zip eclipse-SDK-3.7.1-Linux-gtk.tar.gz 
android-ndk-r6b-linux-x86.tar.tar jdk-6u27-Linux-i586.bin 


android-sdk r13-linux x86.tar 
dmatek@ubuntu:~/Android soft$ 


图 1-77 复制 NDK 安 装 程序 包 到 当前 用 户 目录 


© © Q dmatek@ubuntu: -/Android soft 


File Edit View Terminal Help 


imatek@ubuntu:~$ cd /home/dmatek/Android soft/ 
imatek@ubuntu:~/Android soft$ pwd 

fhome/dmatek/Android soft 

matek@ubuntu:~/Android soft$ 15 

ADT-12.6.6.zip k eclipse-SDK-3.7.1-linux-gtk.tar.gz 
android-ndk-r6b-linux-x86.tar.tar jdk-6u27-Linux-i586.bin 

android-sdk r13-linux x86.tar 

imatek@ubuntu:~/Android soft$ tar -xvf android-ndk-r6b-linux-x86.tar.tar | 


1-78 ”把 NDK 包 进行 解压 


4) 执行 如 下 命令 ,将 android-ndk-r6b 移 动 到 /usr/local/android 目 录 下 ， 如 图 1-79 所 示 。 


$sudo mv android-ndk-réb /usr/local/android/ 


5) 执行 如 下 命令 解压 缩 ， 解 压缩 成 功 后 得 到 NDK 程 序 包 ， 如 图 1-80 所 示 。 


$cd /usr/local/android 


$cd android-ndk-r6b 
$1s 


© @@ dmatek@ubuntu: ~/Android soft 
File Fdit View Terminal Help 


dmatek@ubuntu:~/Android softs ls 

ADT-12.0.0.zip android-sdk r13-linux x86.tar 
android-ndk-r6b eclipse-SDK-3.7.1-linux-gtk.tar.gz 
android-ndk-r6b-linux-x86.tar.tar jdk-6u27-Linux-i586.bin 
dmatek@ubuntu:~/Android softs sudo mv jgndroid-ndk r6b /usr/local/andrcid/ 
[sudo] password for dmatek: 

dmatek@ubuntu:~/Android softs [| 


1-79 ”移动 到 /usr/local/android 目 录 下 


© Ө Ө dmatek@ubuntu: /usr/local/android/android-ndk-r6b 
File Edit View Terminal Help 


dmatek@ubuntu:~/Android soft$ cd /usr/local/android/ 
dmatek&ubuntu:/usr/Local/android$ Ls 
android-ndk-r6b  android-sdk-linux x86 android-sdk r13-linux x86.tar 


dmatek&ubuntu:/usr/local/android$ cd android-ndk-r6b/ 

dmatek@ubuntu: /usr/local/android/android-ndk-r6b$ ls 

build GNUmakefile ndk-stack RELEASE.TXT tests 

docs ndk-build platforms samples toolchains 
documentation.html ndk-gdb README.TXT sources 

dmatek@ubuntu: /usr/local/android/android-ndk-r6b$ | 


图 1-80 ”解压 缩 后 得 到 NDK 程 序 包 


6) 执行 如 下 命令 ， 添 加 NDK 的 环境 变量 到 Linux 系 统 中 ， 如 图 1-81 所 示 。 


sudo vi/etc/profile 


© Ө Ө dmatek@ubuntu: a lal nla elis 


File Edit View Terminal Help 
dmatek@ubuntu: /usr/locel/android/android-ndk-r6b$ sudo vi /еїс/ргоғіле 


1-81 添加 NDK 的 环境 变量 到 Linux 系 统 中 
7) 在 /etc/profile 系 统 文件 中 添加 如 下 程序 代码 ， 如 图 1-82 所 示 。 


export NDK=/usr/local/android/android-ndk-r6b 
export PATH=SPATH:SNDK 


8) 添加 完成 之 后 保存 退出 ， 并 执行 如 下 命令 使 设置 的 环境 变量 生效 ， 如 图 1-83 所 示 。 


[ 


6060 dmatek@ubuntu: /usr/local/android/android-ndk-reb 


File Edit View Terminal Help 


if | -f /etc/bash.bashrc |: then 
. Jetc/bash.bashrc 
fi 
else 
if 


图 1-82 ”在 在 /etc/profile 系 统 文件 中 添加 程序 代码 


© © Ө dmatek@ubuntu: /usr/local/android/android-ndk-r6b 


File Edit View Terminal Help 


dmatek@ubuntu: /usr/local/android/android-ndk-r6b$ source /etc/profile 
dmatek@ubuntu: /usr/local/android/android-ndk- r6b$ i 


图 1-83 使 设置 的 环境 变量 生效 


source/etc/profile 


9) 安装 完成 后 ， 编 译 NDK 中 自 带 的 例子 ， 执 行 如 下 命令 检测 NDK 环 境 搭建 是 否 成 功 ， 如 图 1-84 所 示 。 


© @@ dmatek@ubuntu: /usr/local/android/android-ndk-r6b/samples/hello-jni 


File Edit View Terminal Help 


dmatek@ubuntu: /usr/local/android/android-ndk-réb$ cd samples/hello-jni/ 
dmatek@ubuntu: /usr/Local/android/andrcoid-ndk-r6b/samples/hello-jni$ ndk-build 


Gdbserver 
Gdbsetup 
Compile thumb 
SharedLibrary 


[arm- Linux-androideabi-4.4.3]| 
Libs/armeabi/gdb. setup 
hello-jni <= hello-jni.c 
Libhello-jni.so 


Libs/armeabi/gdbserver 


Install libhello-jni.so => libs/armeabi/libhello-jni.so 
dmatek@ubuntu: /usr/local/android/android-ndk- r6b/samples/hello-jni$ i 


1-84 检测 NDK 环 境 搭 建 是 否 成 功 


$cd samples/hello-jni 
$ndk-build 


看 到 如 图 1-84 显 示 结 果 ， 表 明 NDK 环 境 搭建 成 功 。 


第 2 章 Android 应 用 程序 开发 


2.1 第 一 个 HelloEveryone 


2.1.1 创建 第 一 个 Android 项 目 HelloEveryone 


启动 Eclipse， 点 击 菜单 栏 中 的 “File” 一 “New” 一 “Project” 命 令 ， 如 图 2-1 所 示 。 


© Java — DMA6410XP_TEST/src/tw/ com/dmatek/dma6410xzp/led/Led Control. java — Eclipse Platform ЕЕ 


ЭЗ Edit Run Source Refactor Navigate Search Project Window Help 
Java Project 


Ej He Debug |@ Java | 


Cui Hf Package 


| жиы = A) 
CtrliShiftH Е Task Liss XN FO 


63 Interface 


© Enum 


@ Annotation 


@ Class n | В 


09 є- 


Find: 


C> Uncategorized 


Š Source Folder 

15 Java Working Set 
СЗ Folder 

| $ File 

E} Untitled Text File 
E? JUnit Test Case 

] ^f Task 


Move... 
Rename... 
$ Refresh 


Convert Line Delimiters То 


Switch Workspace 
Restart 


" F5 Example... 


| PY Other... 


Ò Import... 
Lå Export... 


false 

AlttEnter true 

201074218 T 04:17:22 
false 

G: \workspace \DMA6410XP_TEST 
DMAG410XP, TEST 


Properties 


1 R. java [buttonli.2.2/gen/www/ google/cn] 
2 led xml  [DMA6410XP TEST/res/layout] 

3 Led Control. java [DMAS410XP. TEST/...] 
4 GameView Old. java  [Tank/src/org/...] 


Exit 


图 2-1 新 建 工程 


进入 “New Project” 窗 口 ， 如 图 2-2 所 示 。 


选择 创建 一 个 Android 项 目 ， 依 次 点 击 “Android” 一 “Android Project”， 点 击 “Next” 按 钮 进入 “New Android Project” 工 程 信息 窗口 。 图 2-3 所 示 是 一 个 已 经 设置 完成 的 工程 信息 窗口 。 


填写 完成 之 后 点 击 “Finish” 按钮 。 此 时 Eclipse 会 自动 完成 Android 项 目的 创建 过 程 。 接 下 来 就 是 执行 HelloEveryone 项 目 ， 查 看 创建 后 的 效果 。 右 击 HelloEveryone 项 目 ， 在 弹出 菜单 中 依次 选 
择 “Run As" 一 “Android Application" ， 启 动 模拟 器 并 执行 此 程序 ， 如 图 2-4 所 示 。 


Hew Project 


Wizards: 
type filter text 


Andr oid Fr 2j ect 


d Android Test Project 
= Cvs 
H-E Java 
H-E Examples 


图 2-2 “New Project” 47 


=E New Android Project 


New Android Project 


Creates a new Android Projeck resource, 


Project name: HelloEveryone 


Contents 
(@ Create new project in workspace 
L Create project From existing source 


IM Use default location 
C Create project From existing sample 


Samples: 


Build Target 


Target Name Platform | AP... 


E| Google APIs Soogle Inc. L. 
加 | Android 2.0 Android Open Source Project 2,0 
[| Google APIs Google Inc. 2.0 
Е] Android 2.0.1 Android Open Source Project 

F| Google APIs Google Inc, 

W| Android 2.1 Android Open Source Project 

E] Google APIs Google Inc. 


Standard Android platform 2.0.1 


Properties 


Application name: — | HeloEveryone 
Package name: 


[gi Create Activity: 


Min SDK Version: 


(?) | < Back | Mex > | Finish | | Cancel | 


图 2-3 已 经 设置 完成 的 工程 信息 窗口 


若 模 拟 器 显示 如 图 2-5 所 示 信 息 ， 则 表明 HelloEveryone 项 目 创建 成 功 ， 并 且说 明 在 Windows 平 台 下 成 功 搭 建 了 Android 的 开发 环境 。 


g3 gen [Gene 

BA Android 2. — Build Path 
d» assets Source Alt+ShFt+5 
ë> res Refactor Alt+Shft+T 
口 Android: 

Ë) default.pi 222 Import... 


gg Export... 


Sy Refresh 


Close Project 
Close Unrelated Projects 
Assign Working Sets, , , 


сај 
Debug As » Ji 2 Android JUnit Test 
Profile As d 

Validate 


Team 


| 3 Java Applet Alt-Shft--5, А 
š [3| 4 Java Appication Alt-Shft--, J 


Ju 5 Unit Test Alt--ShfE--z, T 
Compare With b 


Restore From Local History... Run Configurations... 


图 2-4 运行 项 目 


_) 5554:=4 21 — [=l x 


Hellotverrone. 


за јао fa farlo fo. 
ofw le [a |r verlo] 

als lo le le la 1 | |, | 

e: lx |с lv le |н | |. |: 


图 2-5 ”模拟 器 运行 结果 


典型 的 Android 项 目 如 图 2-6 所 示 。 


> HelloEveryone 5 125 HelloEveryone 
= sre 日 (m src 


5-88 www. google. cn 
由 m activityllain. java 由 tH www. google. cn 


98 gen [Generated Java Files] gs gen [Generated Java Files] 
BÀ Android 2.1 HM Android 2.1 
= impia DIM + = Android Dependencies 

E> assets 


= bin a . 
Gy res i> bin 


BP drawable-hdpi 5-05 res 


ic launcher. png H-E drawable-hdpi 
E iibi 
{5 drawable-xhdpi WE drexeble-ndpi 
@-@>® layout (> drawable-xhdpi 
[Х| main. xml + > Layout 
BE values H-E values 


№ : 
D nn Ен [d] AndroidMani fest. xml 
а | 


proguerd-project. txt proguard-project. txt 
=) project. properties project. properties 


a) HelloEveryone 项 目 文件 结构 b) Android 的 项 目 结构 


图 2-6 ”典型 的 Android 项 目 组 成 


接 下 来 简单 了 解 一 下 项 目 里 的 各 个 组 成 部 分 。 
' 源 文件 (包含 Activity) 。 源 文件 都 包含 在 src 文件 夹 中 ， 在 “HelloEveryone” 项 目 中 源 文 件 只 有 一 个 ， 就 是 HelloEveryone.java。 


| R.java 文 件 。 这 个 文件 是 Eclipse 自动 生成 的 ， 开 发 者 不 需要 修改 其 中 的 内 容 。 其 内 容 的 修改 也 是 由 Android SDK 自 动 来 处 理 的 。R.java 文 件 对 于 开发 者 来 说 基本 没有 什么 用 处 ,但 是 对 Android 系 统 非 常 有 
用 。 在 这 个 文件 中 ，Android 系 统 对 后 续 介 绍 的 资源 进行 了 全 局 索引 。 在 后 文 介绍 的 res 文件 夹 中 ， 如 果 内 容 发 生 任何 变化 ，R.java 将 被 重新 编译 ， 同 步 更 新 。 


- Android 库 。 这 个 是 应 用 程序 使 用 的 Android 库 ， 图 2-6 显 示 项 目 使 用 的 是 Android 2.1 库 。 


- assets 文 件 夹 。 在 这 个 文件 夹 存 放 多 媒体 等 文件 。 


“ tes 文件 夹 。 这 个 文件 夹 存放 应 用 程序 用 到 的 资源 文件 。 资 源 文件 分 别 用 3 个 文件 夹 进 行 存放 。 当 tres 文件 夹 中 的 资源 文件 发 生变 化 时 ， 前 面 介绍 的 R.java 文 件 的 内 容 就 会 自动 发 生变 化 。 


+ drawable 文 件 夹 。 这 个 文件 夹 主要 存放 应 用 程序 使 用 的 图 片 资 源 。 


` hdpi 里 面 存 放 高 分 辩 率 图 片 ， 如 WVGA (480X800) 。 


+ mdpi 里 面 存放 中 等 分 辨 率 的 图 片 ， 如 HVGA (320X480) 。 


.ldpi 里 面 存放 低 分 辨 率 的 图 片 ， 如 QVGA (240X320) 。 


“ 系统 会 根据 机 器 的 分 辩 率 到 这 几 个 文件 夹 里 面 找到 对 应 的 图 片 。 所 以 在 开发 程序 时 为 了 兼容 不 同 平台 、 不 同 屏幕 ， 建 议 依据 具体 需求 在 这 几 个 文件 夹 存放 不 同 分 辩 率 版 本 的 图 片 。 


"layout 文件 夹 。 这 个 文件 夹 存放 应 用 程序 用 到 的 布局 文件 。 这 些 布局 文件 都 是 XMIL 文 件 。 
“ values 文 件 夹 。 这 个 文件 夹 存放 字符 串 (sttings.xml) . ЙЛ ё, (colors.xml) 、 数 组 (arays.xmb) 资源 。 


+ AndroidManifest.xml。 这 个 文件 非常 重要 ， 相 当 于 应 用 程序 的 配置 文件 。 在 这 个 文件 中 ， 必 须 声明 应 用 的 名 称 ， 应 用 程序 所 用 到 的 Activity、Service 以 及 Receiver 等 信息 。 


第 2 章 Android 应 用 程序 开发 


2.1 第 一 个 HelloEveryone 


214 创建 第 一 个 Android 项 目 HelloEveryone 


启动 Eclipse， 点 击 菜单 栏 中 的 “File” 一 “New” 一 “Project” 命 令 ， 如 图 2-1 所 示 。 


£ Java 一 DNA6410XP TEST/src/tw/com/dmatek/dma64d10xp/led/Led Control. java - Eclipse Platform 


Edit Run Source Refactor Navigate Search Project Window Help 


AlttShifttN 


Üpen File... 


d 029 Java Project 


Close 
Close All 


Ctrl 
CtrltShifttW 


B Package 


@ Class 


ы Save 
=. Save As... 


( Save А1 


Revert 


Ctrl+S 


Ctrl+Shi ft+S 


f Interface 


© Enum 
@ Annotation 
89 Source Folder 


Move... 
Rename... 


27 Refresh 
Convert Line Delimiters To 


1 Java Working Set 
C$ Folder 
[9 File 


[Е Untitled Text File 


e° Print 


Switch Workspace 
Restart 


Ctrl+P 


Е? JUnit Test Case 
(Task 


F3 Example... 


руз Import... 
Lå Export... 


Properties 


1 R java [buttonli.2.2/gen/www/google/cn] 
2 led.xml  [DMA6410XP TEST/res/layout] 

3 Led Control. java [ШМАБ410ХР TEST/...] 
4 GameView 014 java  [Tank/src/org/...] 


Exit 


进入 “New Project" @П, 


如 图 2-2 所 示 。 


选择 创建 一 个 Android 项 目 ， 依 次 点 击 “Android"” > “Android Project”， 点 击 “Next” 按 钮 进入 “New Android Project” 工 程 信息 窗口 。 


AlttEnter 


F Other... 


false 


true 

2010 年 4 月 21 日 FF04:17:22 
false 

G: \workspace\DMABA1OXP_TEST 
DMAG410XP TEST 


图 2-1 新 建 工程 


图 


or 


2-3 所 示 是 一 个 已 经 设置 完成 的 工程 信息 窗口 。 


填写 完成 之 后 点 击 “Finish” 按钮 。 此 时 Eclipse 会 自动 完成 Android 项 目的 创建 过 程 。 接 下 来 就 是 执行 HelloEveryone 项 目 ， 查 看 创建 后 的 效果 。 右 击 HelloEveryone 项 目 ， 在 弹出 菜单 中 依次 选 


择 “Run As" — “Android Application" ， 启 动 模拟 器 并 执行 此 程序 ， 如 图 


2-4 所 示 。 


— Нет Project 


| et es Android Project 
(0 76 Android Test Project 
ae CVS 
E-E Тата 
| (> Examples 


D | «mk [ seso ]| rs | [ cea | 


图 2-2 “New Project” О 


=E New Android Project 


New Android Project 


Creates a new Android Projeck resource, 


Project name: HelloEveryone 


Contents 
(@ Create new project in workspace 
L Create project From existing source 


IM Use default location 
C Create project From existing sample 


Samples: 


Build Target 


Target Name Platform | AP... 


E| Google APIs Soogle Inc. L. 
加 | Android 2.0 Android Open Source Project 2,0 
[| Google APIs Google Inc. 2.0 
Е] Android 2.0.1 Android Open Source Project 

F| Google APIs Google Inc, 

W| Android 2.1 Android Open Source Project 

E] Google APIs Google Inc. 


Standard Android platform 2.0.1 


Properties 


Application name: — | HeloEveryone 
Package name: 


[gi Create Activity: 


Min SDK Version: 


(?) | < Back | Mex > | Finish | | Cancel | 


图 2-3 已 经 设置 完成 的 工程 信息 窗口 


若 模 拟 器 显示 如 图 2-5 所 示 信 息 ， 则 表明 HelloEveryone 项 目 创建 成 功 ， 并 且说 明 在 Windows 平 台 下 成 功 搭 建 了 Android 的 开发 环境 。 


g3 gen [Gene 

BA Android 2. — Build Path 
d» assets Source Alt+ShFt+5 
ë> res Refactor Alt+Shft+T 
口 Android: 

Ë) default.pi 222 Import... 


gg Export... 


Sy Refresh 


Close Project 
Close Unrelated Projects 
Assign Working Sets, , , 


сај 
Debug As » Ji 2 Android JUnit Test 
Profile As d 

Validate 


Team 


| 3 Java Applet Alt-Shft--5, А 
š [3| 4 Java Appication Alt-Shft--, J 


Ju 5 Unit Test Alt--ShfE--z, T 
Compare With b 


Restore From Local History... Run Configurations... 


图 2-4 运行 项 目 
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图 2-5 ”模拟 器 运行 结果 


典型 的 Android 项 目 如 图 2-6 所 示 。 


oLveryone 


e 
(8 src 


5-88 www. google. cn 


由 -及 


activityMain. java 


98 gen [Generated Java Files] 
mA Android 2.1 

MA Android Dependencies 

da assets 


= bin 
= res 


Bae draw able-hdpi 


е) ic_launcher. png 


8-65 dr 
8-65 dr 
8-6 dr 


awable-ldpi 
awable-mdpi 
awable-xhdpi 


= layout 


XJ 


main. xml 


= & values 


ү! 


co 


strings. xml 


С) AndroidManifest. xml 


proguard-project. txt 
=) project. properties 


a) HelloEveryone 项 目 文件 结构 


接 下 来 简单 了 解 一 下 项 目 里 的 各 个 组 成 部 分 。 


> HelloEveryone 
= sre 


由 -月 www. google. cn 
gs gen [Generated Java Files] 


MA Android 2.1 

H-S Android Dependencies 
9, assets 

8-05 bin 

=) = res 

(2 drawable-hdpi 

E> drawable-ldpi 

E> drawable-mdpi 

(2 drawable-xhdpi 

(> layout 

(> values 

AndroidMani fest. xml 

proguard-project. txt 

project. properties 


5 eee 8 8 8 


b) Android 的 项 目 结构 


2-6 典型 的 Android 项 目 组 成 


' 源 文件 (包含 Activity) 。 源 文件 都 包含 在 src 文件 夹 中 ， 在 “HelloEveryone” 项 目 中 源 文 件 只 有 一 个 ， 就 是 HelloEveryone.java。 


“ R.java 文 件 。 这 个 文件 是 Eclipse 自 


用 。 在 这 个 文件 中 ，Android 系 统 对 后 续 介绍 的 资源 进行 了 全 局 索引 。 在 后 文 介绍 的 res 文 


+ Android 库 。 这 个 是 应 用 程序 使 用 


+ assets Ж. 


动 生成 的 ， 开 发 者 不 需要 修改 其 中 的 内 容 。 


的 Android 库 ， 


件 夹 。 在 这 个 文件 夹 存放 多 媒体 等 文件 。 


其 内 容 的 修改 也 是 由 Android SDK 自动 来 处 理 的 。R.java 文 件 对 于 开发 者 来 说 基本 没有 什么 用 处 ,但 是 对 Android 系 统 非 常 有 


件 夹 中 ， 如 果 内 容 发 生 任 何 变 化 ，R.java 将 被 重新 编译 ， 同 步 更 新 。 


2-6 显 示 项 目 使 用 的 是 Android 2.1 Fo 


“res 文件 夹 。 这 个 文件 夹 存放 应 用 程序 用 到 的 资源 文件 。 资 源 文件 分 别 用 3 个 文件 夹 进 行 存放 。 当 tres 文件 夹 中 的 资源 文件 发 生变 化 时 ， 前 面 介绍 的 R.java 文 件 的 内 容 就 会 自动 发 生变 化 。 


` drawable 文 件 夹 。 这 个 文件 夹 主 要 存放 应 用 程序 使 用 的 图 片 资 源 。 


“ hdpi 里 面 存 放 高 分 辩 率 


图 


+ mdpi 里 面 存 放 中 等 分 辨 率 的 


“ ldpi 里 面 存放 低 分 辨 率 的 图 片 ， 


“ 系统 会 根据 机 器 的 分 辩 率 到 这 


片 ， 如 WVGA (480X800) 。 


片 ， 如 HVGA (320X480) 。 


如 QVGA (240X320) 。 


片 。 


几 个 文件 夹 里 面 找 到 对 应 的 


所 以 在 开发 程序 时 为 了 兼容 不 同 平台 、 不 同 屏幕 ， 建 议 依据 具体 需求 在 这 几 个 文件 夹 存放 不 同 分 辨 率 版 本 的 


"layout 文件 夹 。 这 个 文件 夹 存放 应 用 程序 用 到 的 布局 文件 。 这 些 布局 文件 都 是 XMIL 文 件 。 


“ values 文 件 夹 。 这 个 文件 夹 存放 字符 串 (strings.xml) . ЙЯ ё, (colors.xml) 、 数 组 (arrays.xml) 资源 。 


+ AndroidManifestxml。 这 个 文件 非常 重要 ， 相 当 于 应 用 程序 的 配置 文件 。 在 这 个 文件 中 ， 必 须 声 明 应 用 的 名 称 ， 应 用 程序 所 用 到 的 Activity、Service 以 及 Receiver 等 信息 。 


2.2 Android 应 用 程序 组 成 


Android 应 用 程序 使 


Java 作 为 开发 语言 。Android Asset Packaging Tool (AAPT) 工具 把 编译 后 的 Java 程 序 代 码 连 同 其 他 应 用 


程序 需要 的 数据 和 资源 文件 一 起 打包 到 一 个 Android 文 件 包 中 ， 这 个 文 


件 以 .apk 作 为 文件 后 缀 ， 它 是 发 布 应 


* 默认 情况 下 ， 每 个 应 用 程序 均 在 自己 的 Linux 进 程 内 执行 。 当 任 一 应 用 程序 开始 执行 有 


+ 每 个 进程 都 在 自己 的 Java 虚 拟 机 (VM) 中 运行 。 所 以 应 用 程序 代码 实际 上 与 其 他 应 用 


程序 并 安装 到 移动 设备 的 媒介 ， 等 同 于 安装 文件 ， 


程序 。 


户 只 需 下 载 并 安装 此 文件 系统 到 他 们 的 设备 即 可 。 单 个 .apk 文 件 中 的 所 有 程序 代码 被 看 作 一 个 应 


，Android 启 动 一 个 新 进程 ， 当 应 用 程序 不 再 需要 此 进程 而 其 他 应 用 程序 又 需要 系统 资源 时 ， 则 关闭 这 个 进程 。 


程序 的 代码 是 隔离 的 。 


“ 默认 情况 下 ， 每 个 应 用 程序 均 被 赋予 一 个 唯一 的 Linux 用 户 ID， 并 加 以 权限 设置 ， 使 得 应 用 程序 所 处 理 的 文件 系统 仅 对 这 个 用 户 、 这 个 应 用 程序 可 见 。 当 然 ， 也 有 其 他 方法 使 得 这 些 文 件 同样 能 被 别 的 
应 用 程序 所 访问 。 可 以 让 两 个 应 用 程序 共用 同一 个 用 户 ID， 这 种 情况 下 它们 可 以 看 到 彼此 的 文件 系统 。 为 了 保护 系统 资源 ， 拥 有 同一 个 用 户 ID 的 应 用 程序 将 执行 在 同一 个 Linux 进 程 ， 以 及 同一 个 Java 虚 拟 机 


Pe 


Android fiz 


通常 由 一 个 或 多 个 基本 组 件 组 成 ， 前 面 我 们 看 到 Android 应 用 


常用 


的 组 件 就 是 Activity。 事 实 上 Android 应 用 还 包括 Service、Broadcast Receiver, Content Provider 和 Intent。 


224 _ Activity 组 件 


Activity 是 为 响应 用 户 操作 而 显示 的 可 视 化 用 户 接口 。 例 如 ， 一 个 Activity 可 以 显示 一 个 菜单 选项 列表 供用 户 选 择 ， 或 者 显示 一 些 带 有 说 明 的 图 片 。 一 个 短 消息 应 用 程序 可 以 包括 一 个 显示 发 送 对 象 联系 
人 列表 的 Activity， 一 个 给 指定 的 联系 人 写 短 消息 的 Activity 以 及 翻阅 以 前 的 短 消息 和 改变 设置 的 Activity。 尽 管 它们 一 起 构成 一 个 完整 的 应 用 程序 ， 但 每 个 Activity 都 与 其 他 Activity 保 持 独立 ， 它 们 都 是 通过 
继承 Activity 类 实现 的 。 


一 个 应 用 程序 可 以 只 有 一 个 Activity， 或 者 如 上 面 提 到 的 短 消息 应 用 程序 那样 包含 多 个 。Activity 的 数量 和 各 自作 用 取决 于 应 用 程序 及 其 设计 。 通 常 ， 其 中 一 个 Activity 被 标记 为 启动 Activity ( 即 用 户 在 
启动 应 用 程序 时 最 先 看 到 的 Activity) ， 用 该 Activity 启 动 一 个 新 的 Activity 即 可 转向 其 他 的 Activity。 


每 个 Activity 都 提供 了 一 个 默认 的 窗口 以 进行 绘制 。 通 常 ， 这 个 窗口 是 布 满 整个 CD 的， 但 它 也 可 以 是 一 个 位 于 其 他 窗口 之 上 的 小 浮动 窗口 。Activity 也 可 以 使 用 额外 的 窗口 ， 例 如 ， 在 Activity 执 行 过 程 
中 弹出 一 个 需 用 户 反馈 的 小 窗口 ， 或 是 当 用 户 选择 了 屏幕 上 特定 选项 后 弹出 的 重要 信息 窗口 。 


窗口 显示 的 可 视 内 容 是 由 一 系列 视图 构成 的 ， 这 些 视 图 均 继承 自 View 父 类 。 每 个 视图 均 控制 着 窗口 中 一 块 特定 的 矩形 空间 。 父 视图 包含 并 组 织 它 的 子 视图 的 布局 。 叶 节点 视图 (位 于 视图 层次 最 底 端 ) 
在 它们 控制 的 矩形 空间 进行 绘制 ， 并 根据 用 户 实施 的 操作 进行 事件 处 理 ， 所 以 视图 是 Activity 与 用 户 进 行 交 互 的 接口 。 例 如 ， 视 图 可 以 显示 一 个 小 图 片 ， 并 在 用 户 点 击 它 时 产生 事件 。Android 有 很 多 既定 的 
视图 供用 户 直接 使 用 ， 包 括 按钮 、 文 本 框 、 滚 动 条 、 菜 单 选项 和 复 选 框 等 。 


D 


视图 及 其 层次 通过 Activity.setContentView() 方 法 放 入 Activity 窗 口中 。 内 容 视图 (Content View) 是 位 于 视图 层次 根 位 置 的 视图 对 象 。 


1. 创 建 Activity 


在 Android 的 五 个 组 件 Activity、Service、Broadcast Receiver, Content Provider 和 Intent 中 ， 除 了 Intent 以 外 的 四 个 组 件 在 使 用 时 都 要 编写 相应 的 组 件 类 ， 并 在 AndroidManifest.xml 文 件 中 注册 。 
创建 一 个 Activity 类 要 继承 android.Activity 并 覆 写 该 类 的 一 些 方法 ， 代 码 如 下 : 


public class MyActivity extends Activity{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
} 


完成 MyActivity 组 件 编写 后 要 使 用 < activity> 标 签 在 AndroidManifest.xml 文 件 中 实现 注册 。 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com. zhyl.shengmingzhougi" 
android:versionCod x 
android:versionName="1.0" > 
<uses-sdk android:minSdkVersion="7" /> 
<application 
android:icon="@drawable/ic_launcher" 
android:label="@string/app_name" > 
<activity Е 
android:name=".MyActivity" 
android: label="@string/app_name" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
</application> Е 
</manifest> 


2.Activity 生 命 周期 
Activity 的 生命 周期 主要 有 以 下 四 个 状态 : 


- Activity (活动 ) : 一 个 Activity 处 于 激活 画面 时 如 图 2-7 所 示 。 当 某 一 应 用 的 Activity 处 于 活动 状态 时 ， 其 他 Activity 均 不 能 处 于 此 状态 ， 显 示 激 活 画面 时 Activity 上 面 的 内 容 会 变 亮 。 


图 2-7 激活 画面 


“ Paused (暂停 ) : 暂停 状态 是 当前 运行 在 屏幕 上 的 画面 变 暗 、 成 为 禁止 画面 的 状态 。 当 使 用 Toast、 窗 口 或 电话 打 入 时 ， 都 会 让 活动 状态 的 Activity 退 到 暂停 画面 ， 如 图 2-8 所 示 。 


He llo World, Mi n: Activity! 


应 用 测试 


图 2-8 所 禁止 画面 
“ Stopped. 〈 停 止 ) : 停止 状态 是 运行 的 Activity 被 停止 或 不 可 见 的 状态 ，Activity 可 以 通过 其 他 方式 进行 唤醒 。 


: Dead (死亡 ) : 死亡 状态 是 Activity 被 系统 回收 或 未 启动 的 状态 。 


接 下 来 通过 官方 API 提 供 的 生命 周期 状态 图 ( 见 图 2-9) 来 了 解 一 下 与 Activity 生 命 周 期 有 关 的 状态 发 生 转 移 的 7 个 方法 。 


© void onCreate (Bundle savedInstanceState) ， 当 Activity 被 初始 化 时 调用 。 

7 void onStart0 ， 当 Activity 被 初始 化 完成 时 调用 ， 或 从 停止 〈 或 不 可 见 的 ) 状态 变 成 活动 状态 时 调用 ， 如 图 2-9 所 示 的 onStop0 一 onRestart 一 onStart0 运 行 过 程 。 

“ void onRestart0 ， 当 在 停止 (或 不 可 见 的 ) 状态 变 成 活动 状态 时 候 调 用 ， 如 图 2-9 所 示 的 onStop0 一 onRestatt->onStart0 运 行 过 程 。 

- void onResume0 ， 当 Activity 从 不 可 见 状 态 到 活动 状态 〈 激 活 画 面 ) 时 调用 ， 或 者 暂停 状态 回 到 活动 状态 (激活 状态 ) 时 调用 ， 如 图 2-9 所 示 的 onPause0 一 onResume0 运 行 过 程 。 


- void onPause0 ， 当 Activity 从 活动 状态 (激活 状态 ) 到 暂停 状态 (禁止 状态 ) 时 调用 ， 或 者 从 活动 状态 到 暂停 状态 时 调用 。 有 两 种 途径 可 以 从 暂停 状态 回 到 运行 状态 : 一 种 是 onPause0 一 onResume0 ; 
另 一 种 是 onPause 一 onCreate0 ， 这 个 返回 路 径 在 Android 内 存 不 足 情 况 下 发 生 ，Android 首 先 杀 死 不 可 见 (或 停止 ) 的 Activity ， 如 果 Android 内 存 还 是 不 够 ， 再 杀 死 处 于 暂停 状态 的 Activity， 在 这 种 情况 下 处 于 暂 
停 状 态 的 Activity 被 杀 死 后 ， 如 果 要 再 次 进入 运行 状态 就 需要 通过 此 路 径 了 。 


- void onStop0 ， 当 Activity 从 暂停 状态 〈 人 禁止 画面 ) 到 不 可 见 (或 停止 ) 状态 时 调用 。 不 可 见 (或 停止 ) 状态 有 两 种 途径 可 以 回 到 运行 状态 ， 一 种 是 onStop0 一 onRestart0 一 onStatt0 ; 另 一 种 是 
onStob0 一 onCreate0 ， 这 个 返回 路 径 是 在 Android 内 存 不 足 情况 下 发 生 ，Android 首 先 杀 死 不 可 见 (或 停止 ) 的 Activity， 如 果 处 于 不 可 见 (或 停止 ) 状态 的 Activity 被 杀 死 后 ， 当 要 在 此 时 进入 运行 状态 就 需要 通 
过 此 路 径 了 。 


- void onDestroy0 ，Activity 被 回收 时 调用 。 


— — — — 


用 户 再 次 回 | 


| 
| 
| 到 Activity | 


— — — — 一 一 一 一 


其 他 应 用 
需要 时 


| | 
| | 
| | 
L. — 一 一 一 一 — 


下 面 的 代码 通过 日 志 显 示 了 Activity 的 生命 周期 。 


Activity 
启动 


Activity 
处 Tis 云 行 状态 ол 
其 他 Activity 巾 背景 
状态 变 为 前 景 状态 


onDestroy( ) 
Activity 停 目 


2-9 Activity 生命 周期 状态 


22] 


onRestart( ) 


Activity [e] 到 
前 景 状态 


Activity 回 到 | 


M. 


Hij 


— — — 


景 状 态 
JUS 


public class MyActivity extends Activity { 
private static final String TAG="MyActivity"; 
public void onCreate (Bundle savedInstanceState) 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
Log.v (TAG, "OnCreate") 7 
} 
@Override 
protected void onDestroy() { 
// TODO Auto-generated method stub 
super.onDestroy () ; 
Log.v (TAG, "onDestroy") ; 
} 
@Override 
protected void onPause() { 
// TODO Auto-generated method stub 
super .onPause () ; 
Log.v (TAG, "onPause") ; 
) 
GOverride 
protected void onRestart() ( 
// TODO Auto-generated method stub 
super.onRestart(); 
Log.v (TAG, "onRestart"); 


} 

GOverride 

protected void onResume() ( 
// TODO Auto-generated method stub 
super.onResume () ; 
Log.v (TAG, "onResume") ; 


GOverride 


{ 


protected void onStart() { 
// TODO Auto-generated method stub 
super.onStart (); 
Log.v (TAG, "onStart") ; 

} 

@Override 

protected void onStop() { 
// TODO Auto-generated method stub 
super.onStop () ; 
Log.v (TAG, "onStop") 7 


图 2-10 所 示 为 Activity 创 建 时 调用 的 方法 。 


00:23:44.605 281 MyActivity OnCreate 


00:23:44.614 281 yActivity onStart 
00:23:44. 614 281 VACtivityv onResume 


图 2-10 Activity 49 j£ 


当 按 下 模拟 器 右边 的 <Back> 图 键 和 <Home> 图 键 后， 对 处 于 活动 状态 的 Activity 生 命 周 期 的 影响 是 不 一 样 的 。 图 2-11 所 示 为 按 下 <Back> 键 后 调用 的 方法 顺序 。 


MyActivitv onFause 
MyActivitv onStop 
MyActivitv onDestroy 


图 2-11 按 下 <Back> 键 后 Activity 的 状态 变化 


2-12 所 示 为 按 下 <Home> 键 后 调用 的 方法 顺序 。 


V 10-30 00:40:13.184 MyActivity onPause 
V 10-30 00:40:13.735 MyActivitv onStop 


Ий] 
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从 上 面 的 两 个 实验 中 可 以 得 到 如 图 2-13 所 示 Activity 生 命 周期 。 不 难看 出 ， 只 有 按 下 <Back> 键 才能 真正 销毁 一 个 Activity， 而 按 下 <Home> 键 只 能 使 Activity 处 于 停止 状态 ， 再 次 启动 Activity 时 会 恢复 


到 之 前 的 状态 。 


2-13 Activity Ж Ф 5] Jl 


2.2.2 Intent 组 件 


在 Android 的 五 个 组 件 Activity、Service、Broadcast Receiver, Content Provider 和 Intent 中 ， 除 Content Provider 外 ，Activity、Service 和 Broadcast Receiver 这 些 组 件 之 间 的 调用 和 消息 传递 都 是 
居 。 下 面 详细 介绍 Intent 的 使 用 方法 。 


2-14 所 示 ，Intent 提 供 了 Activity、Service 与 Broadcast Receiver 之 间 调 用 的 方法 和 所 需要 的 数 


通过 Intent 完 成 的 。Intent 是 一 种 消息 机 制 ， 如 图 
通过 将 Intent 对 象 传递 给 Content.startActivity() 方 法 或 Activity.startActivityForResult() 方 法 来 启动 一 个 Activity; 通过 将 Intent 对 象 传递 给 Content.startService() 方 法 来 启动 一 个 本 地 Service 对 象 ， 如 


果 Intent 对 象 被 传递 给 Content.bingService()， 则 连接 一 个 远程 Service 对 象 ; 通过 传递 给 Content.sendBroadcast() 等 方法 调用 Broadcast Receiver, 
按照 寻找 目标 组 件 方式 的 不 同 ，Intent 可 以 分 为 两 种 : 
+ 显 式 Intent (Explicit Intent) ， 是 通过 指定 目标 组 件 名 字 寻 找 目标 组 件 ， 一 般 用 于 调用 程序 和 目标 组 件 在 同一 个 应 用 中 的 情况 。 


: K Alntent (Implicit Intent) ， 是 通过 指定 Intent Filter 寻 找 目标 组 件 ， 一 般 用 于 调用 程序 和 目标 组 件 不 在 同一 个 应 用 中 的 情况 。 


一 个 Intent 对 象 可 以 包含 如 图 2-15 所 示 的 信息 。 


Activity 


2-14 Intent J 


2-15 Intent*] £ 


其 中 ， 目 标 组 件 (Components) 可 以 帮助 应 用 程序 发 送 显 式 Intent 调 用 请 求 ， 而 动作 (Action) . BYE (Data) 以 及 类 别 (Category) 可 以 构建 一 个 Intent Filter， 这 个 Intent Filter 可 以 帮助 应 用 
发 送 隐 式 Intent 调 用 请 求 ， 实 现 目标 组 件 查询 。 附 加 数据 (Extras) 用 于 传递 参数 给 目标 组 件 ， 标 志 (Flags) 用 于 指定 目标 组 件 任务 行为 。 


1. 显 式 Intent 


显 式 Intent 请 求 是 通过 指定 组 件 (Components) 实现 直接 调用 。 在 Intent 中 可 以 通过 下 面 的 方法 实现 显 式 Intent: 


` setComponent (ComponentName name) ，ComponentName 类 是 Android 系 统 提供 的 组 件 封装 类 ， 需 要 提供 包 名 、 类 名 或 Content 对 象 ; 
` setClassName (String packageName, String classNameThatPackage) ， 需 要 提供 包 名 和 包 名 中 目标 组 件 类 名 ; 
+ setClassName (Context context, String classNameInThatPackage) ， 需 要 提供 Context 对 象 和 目标 组 件 类 名 ; 


“setClass (Context context, Class classObjectInThatContext) ， 需 要 提供 Context 对 象 和 目标 组 件 类 类 型 。 


onOptionsltemselected 方 法 指定 组 件 构建 显 式 Intent， 代 码 如 下 所 示 : 


public Boolean onOptionsItemSelected (MenuItem item) { 

switch (item.getItemId() ) { 

case ADD MENU ID: 
Intent itadd = new Intent(); 
Itadd.setComponent (new ComponentName ("com.work", "com.work.WeigthAddActivity") ); 
startActivity (itadd) ; 
return true; 

case CONF MENU ID: 
Intent inconf =new Intent(); 
Itconf.setClassName (this, "com.work.WeigthConfigActivity"); 
startActivity (itconf); 
return true; 

) 


Return super.onOptionsItemSelected (item); 


上 面 的 代码 实现 了 在 WeigthListActivity 中 启动 本 应 用 的 WeigthAddActivity 和 WeigthConfig-Activity， 事 实 上 这 就 实现 了 两 个 Activity 之 间 的 转换 。 需 要 注意 的 是 ， 这 里 的 类 名 必须 是 全 类 名 ， 及 “ 包 
名 + 类 名 ”， 如 com.work.WeigthAddActivity 和 com.work.WeigthConfigActivity。setClassName 方 法 的 第 一 个 参数 是 Context 对 象 ， 这 里 使 用 了 this， 即 当前 的 Activity， 因 为 Activity 是 Context 的 子 
类 。 


显 式 Intent 的 构建 还 可 以 通过 Intent (Context context, Class classObjectInThatContext) 构造 方法 实现 ， 代 码 如 下 所 示 : 


public Boolean onOptionsItemSelected (MenuItem item) { 

switch (item.getItemId() ) { 

case ADD MENU ID: 
Intent itadd = new Intent (this, WeigthAddActivity.class); 
startActivity (itadd) ; 
return true; 

case CONF_MENU_ID: 
Intent inconf =new Intent (this, WeigthConfigActivity) ; 
startActivity (itconf) ; 
return true; 

} 


Return super.onOptionsItemSelected (item) ; 


上 面 的 代码 使 用 起 来 比 第 一 种 方式 方便 。 


2. 隐 式 Intent 


隐 式 Intent 一 般 用 于 不 同 应 用 之 间 调 用 的 情况 。 在 不 同 的 应 用 之 间 ， 由 于 不 能 共用 Context 对 象 ， 也 不 能 引用 目标 组 件 的 类 ， 因 此 需要 Intent Filter 实 现 隐 式 Intent 请 求 。 


Intent Filter 对 象 描述 目标 组 件 如 何 响应 隐 式 Intent。 与 显 式 Intent 请 求 的 区 别 是 ， 显 式 Intent 请 求 明确 地 指定 了 目标 组 件 的 类 名 ， 而 隐 式 Intent 请 求 没有 指定 目标 组 件 的 类 名 ， 它 通过 Intent Filter 对 象 
匹配 目标 组 件 规则 找到 符合 要 求 的 目标 组 件 。 目 标 组 件 需 在 其 所 在 应 用 的 AndroidManifest.xml 中 注册 该 组 件 和 Intent Filter, 


gz 


<activity 

android:name-".WeigthListActivity" 

android:label-"Gstring/app name" > 

<intent-filter> Fs 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 

</intent-filter> 

</activity> 


事实 上 ， 显 式 Intent 请 求 的 目标 组 件 也 需要 在 应 用 程序 的 AndroidManifest.xml 中 注册 该 组 件 ， 但 该 组 件 不 需要 注册 Intent Filter, 


<activity android:name=".WeigthAddActivity"android: label="@string/app_name" /> 
<activity android:name=".WeigthModActivity"android: label="@string/app_name" /> 
<activity android:name=".WeigthConfigActivity"android:label="@string/app_name" /> 


2.2.3 Broadcast Receiver 组 件 


Broadcast Receiver (广播 接收 器 ) 是 一 个 专用 于 接收 广播 通知 信息 ， 并 做 出 相应 处 理 的 组 件 。 很 多 广播 源 自 于 系统 程序 代码 ， 例 如 ， 通 知 时 区 改变 、 电 池 电 量 低 、 拍 摄 了 一 张 照片 或 者 用 户 改变 了 语 
言 选项 。 应 用 程序 也 可 以 进行 广播 ， 例 如 ， 通 知 其 他 应 用 程序 一 些 数据 下 载 完成 并 处 于 可 用 状态 。 


应 用 程序 可 以 拥有 任意 数量 的 广播 接收 器 ， 用 于 响应 其 所 有 感 兴 趣 的 通知 信息 。 所 有 的 接收 器 均 继承 自 BroadcastReceiver 父 类 。 


广播 接收 器 本 身 没有 可 视 化 的 用 户 接口 ， 但 它 可 以 启动 一 个 Activity 来 响应 收 到 的 信息 ， 或 者 用 NotificationManager 通 知 用户 。 通 知 可 以 采用 多 种 方式 来 引起 用 户 的 注意 力 ， 如 闪 动 背光 、 振 动 、 播 放 
声音 等 。 一 般 是 在 状态 栏 中 放 一 个 持久 (Persistent) 的 图 示 ， 用 户 可 以 打开 它 并 获取 消息 。 


2.24 ”Service 组 件 


5. 


他 事情 时 在 后 台 播放 音乐 、 从 网 络 获取 一 些 数据 或 者 计算 一 些 东西 并 提供 给 需要 这 个 运 


Service (服务 ) 也 没有 可 视 化 的 用 户 接口 ， 而 是 在 一 段 时 间 内 进行 后 台 执 行 。 例 如 ， 一 个 服务 可 以 在 用 户 做 其 
结果 的 Activity 使 用 。 每 个 服务 都 继承 自 Service 父 类 。 


例如 通过 媒体 播放 应 用 程序 播放 列表 中 的 曲目 是 一 个 不 错 的 例子 。 播 放 器 应 用 程序 可 能 有 一 个 或 多 个 Activity 来 给 用 户 选 择 歌曲 并 进行 播放 。 然 而 ， 音 乐 播放 这 个 任务 本 身 不 应 该 为 任何 Activity 所 处 
理 ， 因 为 用 户 希望 当 他 们 离开 播放 器 应 用 程序 而 开始 做 别 的 事情 时 ， 音 乐 仍 在 继续 播放 。 为 达到 这 个 目的 ， 媒 体 播放 器 Activity 应 该 启用 一 个 执行 于 后 台 的 服务 。 而 系统 将 在 这 个 Activity 不 再 显示 在 屏幕 之 
后 ， 仍 维持 音乐 播放 服务 的 执行 。 可 以 连接 (WE) 至 一 个 正在 执行 的 服务 (如 果 服 务 没有 执行 ， 则 启动 ) 。 连 接 之 后 ， 可 以 通过 那个 服务 提供 的 接口 与 服务 进行 通信 。 对 于 音乐 服务 来 说 ， 这 个 接口 可 以 
许 用 户 暂停 、 回 退 、 停 止 以 及 重新 开始 播放 。 


> 


他 组 件 或 用 户 接口 产生 任何 干扰 ， 它 们 一 般 会 派生 一 个 新 线程 来 进行 一 些 耗 时 任务 (例如 音乐 回放 ) 。 


他 组 件 一 样 ， 服 务 执行 于 应 用 程序 进程 的 主线 程 内 。 所 以 它 不 会 对 


如 同 Activity 和 


2.25 Content Provider 组 件 


Content Provider (内 容 提供 者 ) 将 一 些 特定 的 应 用 程序 数据 提供 给 其 他 应 用 程序 使 用 。 数 据 可 以 存储 于 文件 系统 、SQLite 数 据 库 或 其 他 存储 方式 。 内 容 提供 者 继承 于 ContentProvider 父 类 ， 为 其 他 
应 用 程序 读 取 和 存储 它 管理 的 数据 实现 了 一 套 标准 方法 。 然 而 ， 应 用 程序 并 不 直接 调用 这 些 方法 ， 而 是 使 用 一 个 ContentResolver 对 象 ， 调 用 ContentResolver 对 象 的 方法 。ContentResolver 可 以 与 任意 的 
内 容 提供 者 进行 会 话 ， 与 Content Provider 合 作 来 管理 其 涉及 的 所 有 相关 交互 通信 。 


每 当 出 现 一 个 需要 由 特定 组 件 处 理 的 请 求 时 ，Android 会 确保 那个 组 件 的 应 用 程序 进程 处 于 执行 状态 ， 或 在 必要 时 启动 它 ， 并 确保 那个 相应 组 件 的 实例 存在 ， 必 要 时 会 创建 那个 实例 。 


23 ”使 用 AndroidManifest 文 件 定义 应 用 程序 


AndroidManifest 文 件 为 一 种 特定 格式 的 XML 文件 ， 它 必须 存在 每 一 个 Android 应 用 程序 中 。 这 一 文件 包含 标识 应 用 程序 身份 的 重要 信息 ， 在 其 中 定义 了 应 
的 应 用 程序 组 件 ， 以 及 应 用 程序 运行 所 需 的 许可 权限 和 其 他 的 应 用 程序 配置 信息 。 


AndroidManifest 文 件 处 于 整个 Android 项 目的 最 高 层 。 同 样 ， 如 果 安 装 了 ADT， 那 么 可 以 使 用 Eclipse 文件 编辑 器 对 其 进行 编辑 (如 图 


© HelloEveryone Manif x [Л medi sActivi ty. java 


程序 的 名 称 、 版 本 信息 和 应 


2-16 所 示 ) 。 


ig The application tag describes application-level components contained in the package, as well as general application attributes. 


[V]Define an <application> tag in the AndroidManifest. xml 


X Application Attributes 
Defines the attributes specific to the application. 


Name Persistent 


Theme 


Label Bstring/app name 


Icon @drawable/ic_launcher Manage space activity 
Description Allow clear user data 


Permission | Test only 
Process Backup agent 
Task affinity Allow beckup 


Allow task reparenting ` Kill after restore 


Has code Restore needs application 
М 
Application Nodes (s) (Р) ® (а) (в) ® @ Az 
= [A] . Activityiain “| 


e (1) Intent Filter 

(Q android. intent. action. MAIN (Action) 

© android. intent. category. LAUNCHER (Category) 
A . MediaActivity Up 
À| Audiodctivity a 


FE) Manifest (a) Application (rj Permissions 回 | Instrumentation (5) Androi dani fest. xnl 


图 2-16 使 用 文件 编辑 器 编辑 AndroidManifest 文 件 


当然 ， 也 可 以 通过 点 击 文件 编辑 器 最 右 侧 的 标签 ， 直 接 编辑 XML 文件 ， 如 图 2-17 所 示 。 


程序 所 依赖 


大 多 数 AndroidManifest 文 件 包含 一 个 <manifest> 标 记 ， 其 中 包含 一 个 <application> 标 记 。 下 面 是 HelloEveryone 应 用 程序 的 AndroidManifest 文 件 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="www.google.cn" 
android: versionCode="1" 
android: versionName="1.0" > 
«uses-sdk android:minSdkVersion-"7" /> 
«application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name" > 
<activity 
android:name-".ActivityMain" 
android:label-"8string/app name" > 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".MovingActivity" ></activity> 
<activity android:name-".AudioActivity" ></activity> 
<activity android:name=".StillActivity" ></activity> 
</application> 
<uses-permission android:name="android.permission.RECOR_AUDIO"></uses-permission> 
<uses-permission android:name="android.permission.SET_WALLPAPER"></uses-permission> 
<uses-permission android:name="android.permission.CAMERA"></uses-permission> 
<uses-permission android:name="android.permission.WRITE_SETTING"></uses-permission> 
</manifest> 


1 <?xml version="2.0" encodings"utf-8"?» 

29 «manifest xmlns:android="http://schemas. android. com/apk/res/android" 
packages "www. google. cn" 

android: versionCode=#"i" 

android: versionName="2.0" > 


о om bw 


s-sdk android:minSdkVersion-"7" /> 
application 
android: icon="@drawable/ic_ launcher" 
android: label="@string/app name" > 
<activity 
android: name=".ActivityMain" 
android: label="@string/app name" > 
<intent-filter> 
«action android: name="android.intent.action.MAIN" /> 


«category android: name="aendroid.intent.category.LAUNCHER" /> 
</intent-filter> 
«/activity» 
«/application» 
</manifest> 


Manifest [А] Application (P) Permissions [加 | Instrumentation |2) AndroidManifest. xml 


图 2-17 ”直接 编辑 AndroidManifest 文 件 
AndroidManifest 文 件 提供 的 与 HelloEveryone 应 用 程序 有 关 的 配置 信息 如 下 所 示 : 
“ 应 用 程序 使 用 包 名 称 为 “www.google.cn”。 
“ 应 用 程序 的 版 本 名 称 为 “1.0”。 
“ 应 用 程序 的 版 本 号 为 “1”。 
“ 应 用 程序 名 称 和 标签 (label) 存储 于 包含 在 “/res/values/strings.xml” 资 源 文件 中 的 名 为 “(@string/app_name” 的 字符 囊 中 。 
- 应 用 程序 拥有 4 个 Activity (ActivityMain、MovingActivity、AudioActivity、StillActivity) o 
+ ActivityMain 是 应 用 程序 的 主 入 口 点 。 
“ 应 用 程序 的 运行 需要 以 下 许可 权限 : 录制 音频 的 权限 、 在 手机 设备 上 进行 墙纸 设 定 的 权限 、 访 问 内 置 摄像 头 的 权限 和 写 入 设置 的 权限 。 


下 面 详细 介绍 这 些 重要 配置 信息 。 


23.1 ”管理 应 用 程序 身份 


AndroidManifest 文 件 定义 了 应 用 程序 的 属性 。 包 名 称 必须 在 AndroidManifest 文 件 的 <manifest> 标 签 内 ， 使 用 package 属 性 进行 定义 ， 如 下 所 示 : 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="www.google.cn" 
android: versionCode="1" 
android:versionName="1.0" > 


1. 为 应 用 程序 指定 版 本 号 


为 应 用 程序 指定 版 本 号 是 让 应 用 程序 在 这 某 一 开发 领域 内 保持 一 定 地 位 的 重要 原因 。 明 智 地 为 应 用 程序 指定 版 本 号 可 以 帮助 减少 版 本 混乱 与 疑惑 ， 同 时 也 能 让 产品 支持 与 升级 变 得 更 容易 。 在 
<manifest> 标 记 内 定义 了 两 个 版 本 属性 : 版 本 名 称 和 版 本 号 。 


< 版 本 名 称 (andtoid:versionName) 是 一 个 由 开发 人 员 定 义 的 、 用 户 易 懂 的 版 本 属性 。 当 用 户 管理 他 们 设备 上 的 应 用 程序 ， 或 从 应 用 市 场 购买 下 载 应 用 程序 时 ， 版 本 名 称 信息 将 呈现 给 用 户 。 而 开发 人 员 
则 通过 这 一 版 本 信息 跟踪 应 用 程序 在 开发 领域 内 的 版 本 。 


+ 版 本 号 (android:versionNumber) 是 版 本 的 标识 号 ， 版 本 号 能 使 用 户 了 解 所 使 用 的 操作 系统 是 否 为 最 新 的 版 本 以 及 它 所 提供 的 功能 与 设施 。 


2. 给 应 用 程序 加 上 名 称 和 标签 


在 AndroidManifest 文 件 中 ， 可 以 将 应 用 程序 图 标 (android:icon) 和 用 户 可 见 标签 (android:label) 作为 <application> 标 记 的 属性 进行 设 定 。 可 以 将 应 用 程序 的 图 形 和 字符 串 资源 组 件 设 定 为 已 经 
定义 ， 代 码 如 下 所 示 : 


<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 


2.32 ”注册 Activity 和 其 他 应 用 程序 组 件 


应 用 程序 的 每 一 个 Activity 均 需要 在 AndroidManifest 文 件 中 使 用 <activity> 标 签 进行 定义 。 例 如 ， 下 面 的 代码 定义 了 一 个 名 为 AudioActivity 的 Activity 类 : 


«activity android:name-".AudioActivity" ></activity> 


这 一 Activity 必 须 在 www.google.cn 包 中 以 类 的 方式 进行 定义 。 


1. 使 用 Intent Filter 为 应 用 程序 指定 主 入 口 Activity 


可 以 指定 Activity 为 主 入 口 ， 方 法 是 在 应 用 程序 的 AndroidManifest 文 件 中 使 用 MAIN 动 作 和 LAUNCHER 类 型 配置 Intent Filter, 


a 


下 面 的 代码 将 一 个 名 为 ActivityMain 的 Activity 配 置 为 应 用 程序 的 主 入 口 : 


<activity 
android:name-".ActivityMain" 
android: label="@string/app_ name" > 
<intent-filter> Е 
<action android:name="android.intent.action.MAIN" /> 
«category android:name="android. intent .category. LAUNCHER" /> 
</intent-filter> 
</activity> 


2. 配 置 其 他 Intent Filter 


Android 操 作 系 统 使 用 Intent Filter 来 解析 隐 式 Intent。lntent Filter 可 以 应 用 于 Activity、Service 和 Broadcast Receiver。Filter 声 明 该 组 件 为 开放 的 ， 可 以 接收 任何 发 送 至 Android 操 作 系统 的 匹配 其 
规则 的 Intent。 


Intent Filter 使 用 <intent-filter> 标 签 定义 ， 它 必须 包含 至 少 一 个 <action> 标 签 ， 也 可 以 包含 其 他 的 信息 ， 如 <category> 和 <data> 代 码 段 。 下 面 是 一 个 Intent Filter 的 代码 段 示例 ， 它 应 该 出 现在 
<activity> 区 段 中 : 


<activity 

android: label="@string/app_name" 

android:name-".ActivityMain" > 
<intent-filter> 
«action android:name-"android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.BROWSABLE " /» 
«category android:name-"android.intent.category.DEFAULT " /» 
«data android:scheme-" geoname" /> 

«/intent-filter» 


上 面 的 代码 表明 使 用 预定 义 的 Intent Filter 是 使 用 VIEW 行为 来 定义 的 ， 这 一 行为 用 于 查看 特定 的 内 容 。 同 时 ， 它 是 BROWSABLE (可 导航 ) 的 ， 并 且 使 用 了 geoname 作 为 其 规则 ， 这 样 ， 如 果 某 个 Uri 
以 “geoname: //” 开 头 ， 那 么 带 有 这 一 Intent Filter 的 Activity 将 会 运行 。 


一 个 单独 的 Activity 可 以 有 多 种 用 途 。 不 同 于 将 所 有 的 IntentFilter 置 于 同一 个 Activity 中 ， 可 以 使 用 别名 来 为 相同 的 后 台 Activity 编 写 不 同 的 Intent Filter 和 其 他 元 数据 。 实 现 这 一 功能 需要 使 用 <activity- 
alias> 标 签 。 


3. 注 册 Service 和 Broadcast Receiver 


Activity、Service 和 Broadcast Receiver 必 须 在 AndroidManifest 文 件 中 注册 。Service 和 Broadcast Receiver 分 别 使 用 <service> 与 <receiver> 标 签注 册 ， 它 们 均 使 用 Intent Filter, 


4. 注 册 Content Provider 


Android 中 的 Content Provider 机 制 可 支持 在 多 个 应 用 中 存储 和 读 取 数据 。 这 也 是 跨 应 用 共享 数据 的 唯一 方式 。Android 提 供 了 一 些 主要 数据 类 型 的 Content Provider， 比 如 音频 、 视 频 、 图 片 和 私人 
通讯 录 等 。 可 在 android.provider 包 下 面 找 到 一 些 Android 提 供 的 Content Provider。 当 需要 获得 这 些 Content Provider， 用 于 查询 它们 包含 的 数据 时 ， 必 须 给 它们 适当 的 读 取 权 限 。 即 必须 在 
AndroidManifest 应 用 程序 的 图 形 和 字符 串 资源 组 件 <provider> 标 签 声明 这 一 权限 。 如 下 代码 所 示 : 


<provider android:name="com.package.name.MyContentProvider" 
android: authorities="com.package.name.mycp"> 
</provider> 


2.3.3 ”使 用 许可 权限 


一 般 情况 下 ，Android 操 作 系 统 处 于 锁定 状态 ， 所 以 应 用 程序 仅 有 有 限 的 “能 力 ” 在 其 线程 之 外 对 操作 系统 造成 不 利 的 影响 。 


1. 注 册 应 用 程序 所 需 的 许可 权限 


Android 应 用 程序 默认 没有 任何 许可 权限 。 任 何 共享 资源 和 授权 访问 
这 些许 可 权限 将 在 应 用 程序 安装 时 授予 。 


无 论 是 共享 数据 (如 联系 人 数据 库 ) ， 还 是 访问 底层 硬件 (如 内 置 摄像 头 ) 都 必须 在 AndroidManifest 文 件 内 显 式 注 册 。 


下 面 的 代码 片段 是 从 前 面 的 AndroidManifest 文 件 中 提取 的 ， 它 使 用 <uses-permission> 标 签 定义 了 使 用 内 置 摄像 头 的 权限 。 


<uses-permission android:name-"android.permission.CAMERA" /> 


完整 的 许可 权限 列表 可 以 在 android.Manifest.permission 类 中 找到 。 应 用 程序 的 Android-Manifest 文 件 只 应 该 包含 它 运行 所 需 的 许可 权限 。 在 安装 时 用 户 将 会 被 告知 每 一 个 Android 应 用 程序 所 需 的 
许可 权限 列表 。 


2. 注 册 应 用 程序 授予 其 他 应 用 程序 的 许可 权限 


应 用 程序 也 可 以 使 用 <permission > 标签 定义 属于 自己 的 许可 权限 。 许 可 权限 必须 使 用 android.permission 属 性 进行 描述 ， 并 且 授 予 某 个 特定 的 应 用 程序 组 件 ， 如 Activity。 


许可 权限 可 以 在 以 下 若干 时 刻 强制 验证 : 


” 当 启 动 一 个 Activity 或 Service 时 ; 


- 3533 I5] d Content Provider 提 供 的 数据 时 ; 


+ 当 处 在 函数 调用 层 时 ; 


- 当 发 送 和 接收 Intent 某 项 操作 时 。 


许可 权限 可 以 拥有 3 种 主要 的 保护 级 别 : normal (正常 ) 、dangerous (危险 ) 和 signature (签名 ) 。normal 保 护 级 别 是 一 个 针对 应 用 程序 细节 权限 的 默认 级 别 。dangerous 保 护 级 别 用 于 高 风险 操 
作 ， 它 们 将 可 能 对 设备 造成 不 利 的 影响 。 由 于 被 控制 的 应 用 程序 具有 互 操作 性 (interoperability) ，signature 保 护 级 别人 允许 任何 使 用 相同 签名 的 应 用 程序 使 用 其 组 件 。 


许可 权限 还 可 以 细 分 为 若干 类 型 ， 称 为 permission groups (许可 权限 组 ) ， 它 们 描述 或 警告 特定 Activity 需 要 许可 权限 的 原因 。 例 如 ， 许 可 权限 会 应 用 于 一 些 Activity， 它 们 可 能 需要 提供 如 位 置 和 个 人 
信息 等 敏感 用 户 数据 (android.permission-group.LOCATION) ， 访 问 底层 硬件 (android.permission-group.HARDWARE_CONTROLS) ， 或 进行 会 使 用 户 付费 的 操作 (android.permission- 
group.COST MONEY) 。 完 整 的 许可 权限 组 列表 可 以 在 Manifest.permission_group 类 中 找到 。 


3. 在 Uri 层 级 上 增强 Content Provider 权 限 


可 以 使 用 <grant-uri-permission > 标签 引入 处 于 Uri 级 别 的 细节 权限 。 


2.3.4 ”指定 应 用 程序 所 需 输入 设备 和 软件 


Android 1.5 在 Manifest 文 件 中 引入 了 一 个 名 为 <uses-configuration> 的 标记 ， 其 中 可 以 使 用 <uses-configuration>Manifest 标 记 配置 的 属性 有 : android:reqFiveWayNav, 
android:reqHardKeyboard、android:reqKeyboardType、android:reqNavigation 和 android:reqTouchscreen。 下 面 举例 说 明 属 性 的 使 用 代码 : 


<uses-configuration android: reqTouchScreen-"finger"/» 


对 于 上 面 介绍 的 五 向 导航 (five-way navigation) 对 应 不 同 的 属性 配置 : 硬件 键盘 和 键盘 类 型 ;导航 设备 ， 如 方向 手柄 (directional pad) 、 轨 迹 球 和 滚轮 ; 以 及 触 屏 。 支 持 的 配置 如 表 2-1 所 示 。 


表 2-1 可 以 使 用 <uses-configuration>Manifest 标 记 配置 的 属性 


属性 名 称 属 性 ff 
应 用 程序 是 否 需 要 五 向 导航 控制 ， 

如 方向 手柄 、 轨 迹 球 和 滚轮 

android:reqHardKeyboard 应 用 程序 是 否 需要 硬件 键盘 true, false 

undefined (默认 ) 

nokeys (无 需 键盘 ) 

qwerty (需要 标准 QWERTY 键盘 ) 

twelvekey (需要 12 键 键盘 ) 

undefined (默认 ) 

nonav (无 需 导 航 控制 ) 

android:reqNavigation 需要 的 导航 设备 类 型 dpad (需要 方向 手柄 ) 

trackball (需要 轨迹 球 ) 

wheel (需要 方向 滚轮 ) 

undefined (默认 ) 

notouch (无 需 触 屏 ) 

stylus (需要 手写 笔触 屏 ) 

finger (需要 手指 解 屏 ) 


android:reqFive WayNav true, false 


需要 的 键盘 类 型 
android:reqKeyboardType 注意 : 键盘 可 以 是 硬件 键盘 也 可 
以 是 软 键盘 


android:reqTouchScreen 需要 的 触 屏 类 型 


对 于 给 定 的 属性 ， 并 不 支持 “OR” (sk) 。 如 果 应 用 程序 需要 任何 硬件 键盘 和 手指 或 手写 笔 的 触 屏 输入 ， 那 么 需要 在 AndroidManifest 文 件 中 包含 两 个 分 离 的 <uses-configuration> 标 记 ， 代 码 如 下 
所 示 : 


< uses-configuration android:reqHardKeyboard="true" 
android: reqTouchScreen-"finger" /> 
< uses-configuration android:reqHardKeyboard="true" 
android: reqTouchScreen="stylus" /> 


2.3.5 “使 用 库 和 Android SDK 版 本 


可 以 指定 应 用 程序 所 需 的 最 低 Android SDK 版 本 ， 并 且 可 以 在 Android Manifest 文 件 中 注册 第 二 个 应 用 程序 所 链接 (link) 的 包 。 


1 .指定 最 低 Android SDK 版 本 


默认 情况 下 ，Android 应 用 程序 被 假定 为 可 以 在 所 有 完整 版 本 的 Android SDK 上 进行 移植 (1.0 及 以 上 ， 不 支持 Beta 版 本 ) 。 


如 果 应 用 程序 需要 运行 在 一 个 不 同 的 SDK 版 本 上 ， 那 么 必须 在 <manifest> 标 记 段 内 使 用 <uses-sdk> 标 记 显 式 地 指明 。< uses-sdk> 标 记 拥 有 一 个 称 为 android:minsdkVersion 的 属性 ， 这 是 一 个 整 型 
值 。 该 值 并 没有 和 SDK 版 本 直接 对 应 。 相 反 ， 它 是 Android SDK 开 发 人 员 设 定 的 同 SDK 相 关联 的 经 过 修订 后 的 API 级 别 (level) 。 所 以 ， 需 要 查看 SDK 文 档 以 确定 每 个 版 本 的 API 级 别 。 


例如 ， 如 果 应 用 程序 需要 Android SDK 1.1 中 的 APl， 那 么 需要 查看 SDK 的 文档 ， 找 到 Android SDK 1.1 (Release 1) 被 定义 为 API Level 2。 所 以 ， 在 Android Manifest 文 件 中 的 <manifest> 标 记 内 插 
入 下 面 的 代码 : 


< uses-sdk android:minSdkVersion="2" /> 


换言之 ， 如 果 应 用 程序 需要 Android SDK 1.5 R1， 那 么 最 低 SDK 版 本 号 应 为 3， 如 下 所 示 : 


< uses-sdk android:minSdkVersion="3" /> 


就 是 这 样 简单 。 一 般 而 言 需要 使 用 可 能 的 最 低 SDK 版 本 ， 因 为 这 一 信息 将 在 安装 时 验证 ， 而 且 希 望 应 用 程序 能 够 适应 尽 可 能 多 的 移动 设备 。 


现在 ，<minSdkVersion> 标 签 是 在 Android Market 上 发 布 应 用 程序 所 必需 的 。 


2. 链 接 到 其 他 包 


程序 被 链接 到 标准 Androidq 包 (如 android:app) 并 且 能 够 知道 自己 的 包 。 但 是 ， 如 果 应 用 程序 链接 到 其 他 附加 的 包 ， 那 么 它们 必须 在 AndroidManifest 文 件 的 <application> 


默认 情况 下 ， 每 一 个 应 
标记 内 使 用 <uses-library> 标 记 注 册 。 例 如 : 


< uses-library android:name-"com.mylibrary.stuff" /> 


2.3.6 ”定义 应 用 程序 的 其 他 配置 参数 


不 同 的 标签 区 段 ， 当 然 还 有 许多 前 面 已 经 讨论 的 包含 于 每 一 个 标签 中 的 属性 。 


至 此 已 经 讲解 完了 Android Manifest 文 件 的 基础 内 容 ， 但 是 在 Android Manifest 文 件 内 还 有 许多 其 他 可 用 配置 ， 它 们 使 


其 他 一 些 可 以 在 Android Manifest 文 件 中 进行 配置 的 特性 包括 : 


- 4& JI] < application 之 标签 的 属性 设置 应 用 程序 域 (applicationwide) 主题 ; 


* 4& Jf] «instrumentation > 4$ 2 BC Ж 420] (instrumentation) 设置 。 


可 以 参考 Android 文 档 了 解 更 多 的 可 用 特性 (property) 和 属性 (attribute) ВОК, TIE. 


24 ”常用 Widget 控 件 介 绍 


在 本 节 中 详细 介绍 Android 应 用 程序 设计 中 的 常用 控件 ， 内 容 包 括 项 目 建立 、 控 件 添加 、 布 局 、 控 件 响应 、 仿 真 器 调试 执行 等 。 
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Android 应 用 开发 的 基础 。 


2.4.1 用 Widget 控 件 创 建 Android 项 目 


在 Eclipse 中 创建 一 个 新 Android 项 目 ， 名 字 为 button11.2.2。 具 体 步 骤 如 下 : 


1) 依次 点 击 “File” — "New" > "Android Project”， 打 开 新 建 Android 项 目 窗口 ， 如 图 2-18 所 示 。 


2) 在 新 建 项 目 窗口 中 填写 相应 信息 ， 然 后 点 击 “Finish” 按 钮 ， 完 成 创建 。 图 2-18 右 侧 的 图 是 创建 完成 后 的 项 目 文件 列表 。 


面 介 绍 控件 时 一 般 只 会 给 出 如 右 图 的 项 目 文件 列表 ， 读 者 可 以 自行 推导 出 创建 项 目 时 的 填写 信息 。 


从 图 2-18 右 图 所 示 的 项 目 文件 列表 可 以 看 出 左 图 创建 项 目 时 需要 填写 的 重点 信息 ， 所 以 在 后 


在 图 2-18 所 示 的 项 目 中 ，button.java 是 应 用 程序 的 入 口 ， 点 击 这 个 文件 ， 可 以 看 到 其 中 的 程序 代码 : 


package www.google.cn; 
import android.app.Activity; 
import android.os.Bundle; 
public class button extends Activity { 
/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 


} 


在 上 述 代码 的 “setContentView (Rlayout.main) ”一 行 中 关联 了 一 个 布局 文件 main.xml， 接 下 来 将 在 这 个 项 目 中 进行 按钮 控件 实验 。 


© New Android Project 


New Android Project 


Creates a new Android Project resource. 


Project name: |button11.2.2 


Contents oR 
(SCreate new project in workspace ==., 
OCreate project from existing source 


[7]Use default location 


Location: |G:/workspace/buttonl1.2.2 


OCreate project from existing sample 


Samples; àpiDemos 


Build Target 


ES buttonll.2.2 
日 -外 sre 


Target Name Vendor 


CI Android 1.5 Android Üpen Source Project 
[Г] Google APIs Google Inc. 
C] Android 1.6 Android Open Source Project 
[Г] Google APIs Google Inc. 
Г] Android 2.0 Android Open Source Project 
[Г] Google APIs Google Inc. 
[Г] Android 2.0. Android Üpen Source Project 
C] Google APIs Google Inc. 
Android 2.1 Android Open Source Project 
C] Google APIs Google Inc. 


Standard Android platform 2.1 


ооо PO Юю Pree 
—-—-oo0o0o0momdudu 


kap 


i = assets 
= S> res 


Properties 


Application name: 
Package name: 
M]Create Activity: 


Min Version: 


8-0 drawable-hdpi 
8-0 drawable-ldpi 
(> drawable-mdpi 
H-E layout 

(> values 

回 AndroidMani fest. xml 
Bl default.properties 


图 2-18 创建 一 个 新 Android 项 目 


2.4.2 按钮 


按钮 控件 (Button) 在 Android 应 用 程序 设计 中 使 用 广泛 ， 例 如 ， 很 多 界面 中 都 有 一 个 “确认 ”或 者 “取消 ”按钮 ， 表 示 一 个 动作 的 结束 或 另 一 个 动作 的 开始 。 使 用 上 面 创建 的 Android 项 目 ， 在 这 个 
项 目的 主 界面 上 放置 一 个 按钮 ， 并 在 应 用 程序 中 给 它 添加 一 个 响应 事件 ， 相 关 布局 文件 程序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"? 

«Button android: id="@+id/button" 

android:layout width-"wrap content" 

android:layout height-"wrap content" 

android:text-"Button" /» 

</LinearLayout> 


上 述 程序 代码 在 主 界面 放置 了 一 个 android:id 为 button 的 按钮 ， 这 个 id 将 被 gen/package name (这 里 是 www.google.cn) /Rjava 这 个 文件 所 记录 ， 如 图 2-19 所 示 。 


«€ cə ®/* AUTO-GENERATED FILE. DO NOT MODIFY.[] 
| e activity intenti1.3.1 I a 
由 e activity intent11.3.2 | package wuwgoogLe;onj 


由 Е autocompletetextviewl1.2.3 
a GS buttoni1.2.2 public final class R ( 


8-08 src e public static final class attr ( 
日 - 宙 www. google. cn ) 
m button. java Э public static final class drawable { 
à gs c E Tau A public static final int icon=0x7f020000; 
E- www. google. cn ) 
П В. java e public static final class id ( 
BÀ Android 2.1 public static final int button-0x7f050000; 
Gs assets | ) 
B $5 res ‹ public static final class layout { 
由 -全 dreweble-hdpi public static final int main-0x7f030000; 
HGS drewable-ldpi ) 
Gp dreneble-napi public static final class string ( 
G layout public static final int app name-O0x7f040001; 
@ values public static final int hello=0x7f040000; 
回 Androidllani fest. xml 
B default.properties 


|E Package Expl 53 \ ВЕ Outline | ^ C || [J] Led Control. java 
zZ 


2-19 Rjava x4} 


设 定 Button 宽 度 (layout width) 和 高 度 (layout height) 都 是 根据 内 容 调整 (wrap_content) ， 并 设 定 其 显示 的 文字 是 “Button” ， 然 后 单 击 运行 这 个 Android 项 目 ， 可 以 看 到 其 效果 如 图 2-20 
所 示 。 


添加 按钮 事件 响应 函数 程序 代码 如 下 : 


private Button.OnClickListener button listener = new Button.OnClickListener () { 
public void onClick (View у) { 
setTitle ("button has been pressed!"); 
l 
1; 


在 上 述 代码 中 ， 当 按 下 按钮 时 在 Title 上 显示 “button has been pressed!” , 


在 主 函 数 中 添加 Button 变 量 并 为 Button 设 置 响应 函数 : 


button= (Button) findViewById (R.id.button) ; 
button.setOnClickListener (button_listener) ; 


重新 运行 程序 ， 然 后 点 击 “Button” 按 钮 ， 将 出 现 如 图 2-21 所 示 的 效果 。 


由 于 篇 幅 限 制 ， 上 述 程序 代码 只 是 重点 部 分 的 节选 ， 添 加 Button 变 量 和 Button 的 响应 函数 要 注意 添加 的 位 置 。 


Button 


82-20 ”运行 效果 


ШИЙ 6 2:12 AM 


button has been pressed! 


2-21 ”点击 “Button” 按 钮 后 的 效果 


243 SAE 


文本 框 (TextView) 直接 继承 了 View， 它 的 作用 就 是 在 界面 上 显示 文本 。 下 面 通过 实例 来 介绍 TextView 用 法 。 


创建 一 个 新 Android 项 目 ， 


*i 


= textviewll.2.3 
=) sre 
Е | www. google. cn 
由 n activitylMain. java 
ud gen [Generated Java Files] 
BA Android 2.1 
S assets 


B d» res 


(> drawable-hdpi 
+) (> drawable-ldpi 
[= drawable-mdpi 
+- (> layout 
-E> values 
1) AndroidManifest. xml 
x default. properties 


图 2-22 项 目 文件 列表 


模仿 上 个 实验 添加 一 个 按钮 ， 当 点 击 这 个 按钮 时 ， 改 变 TextView 显 示 的 信息 。 首 先 在 main.xml 文 件 中 添加 一 个 Button 控 件 和 一 个 TextView 控 件 ， 并 分 别 设置 其 id 为 button 和 text。 效 果 如 图 2-23 所 
示 。 相 关 布局 文件 程序 代码 如 下 : 


<TextView 
android: id="@+id/text" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:text-"8string/hello" 

/> 

«Button android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"press me" Е 
android: id="@+id/button" 

/> 


然后 在 activityMain.java 文 件 中 添加 对 这 个 按钮 的 单 击 动作 和 监听 的 响应 ， 当 发 生 单 击 事件 时 ， 将 打开 TextView 的 界面 。text 和 button 的 获取 以 及 设置 button 响 应 的 程序 代码 如 下 : 


button= (Button) findViewById (R.id.button) ; 
text- (TextView) findViewById (R.id.text) ; 


button.setOnClickListener (text_button_listener) ; 


"press me” 按 钮 的 监听 器 是 函数 text_button_listener， 其 实现 程序 代码 如 下 : 


private Button.OnClickListener text_button_listener =new Button.OnClickListener () 


public void onClick (View ү) { 
text.setText ("I am textview show") ; 


} 


从 上 面 的 程序 代码 可 以 看 出 ， 当 点 击 “press me” 按 钮 时 ， 在 TextView 控 件 中 显示 信息 “| am textview show" ， 如 图 2-24 所 示 。 


Hello World, activity 


Press më 


textview 


I am textview show 


| press me 
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图 2-24 ”点 击 后 显示 


2-24 中 可 以 发 现 ， 控 件 按照 设 定 的 功能 正确 地 显示 了 。 除 了 上 面 


到 的 一 些 


属性 ，TextView 控 件 还 有 很 多 其 他 的 


属性 ， 可 以 参考 Android SDK 附 带 的 文件 。 


TextView 控 件 功能 单一 ， 使 用 起 来 很 简单 ， 一 般 用 在 需要 显示 信息 的 时 候 。 它 不 能 输入 信息 ， 只 能 在 初始 设 定 或 者 在 程序 运行 期 间 修改 ， 如 果 需 要 在 程序 中 动态 地 修改 TextView 中 的 值 ， 就 需要 使 用 其 
Android:id 的 值 获取 该 控件 并 调用 TextView.setText() 方 法 设置 需要 显示 的 信息 。 
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学 习 完 TextView 控 件 ， 接 着 看 一 个 与 其 非常 类 似 的 控件 EditText (编辑 框 ) 。 按 照 如 图 2-25 所 示 的 项 目 文件 列表 创建 一 个 Android 项 目 。 


S-E edittextl1.2.4 
E (S sre 
Ee www. google. cn 
П activity. java 
+ ín gen [Generated Java Files] 
+B Android 2.1 
s 25, assets 
= Ыз, res 
J-l drawable-hdpi 
+> drawable-ldpi 
2 drawable-mdpi 
[= layout 
[2 values 
C AndroidManifest. xml 
~ default. properties 


2-05 项 目 文件 列表 


本 小 节 将 综合 运用 前 面 所 学 的 控件 一 一 先 给 系统 默认 的 TextView 添 加 id， 并 给 它 添加 一 些 显 示 属性 (如 字体 大 小 、 颜 色 等 ) ;在 TextView 下 面 放置 一 个 EditText; 最 后 在 EditText 下 面 放置 一 个 
Button。 相 关 的 布局 文件 程序 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
> 


<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android: textSize="20sp" e 


id: textColor="#ffff0fff" 
text="@string/hello" 
android:id="@+id/text" 
/> 
<EditText 


id:layout width-"fill parent" 
id:layout height-"wrap content" 
android: id="@+id/edittext" 


/> 

<Button 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
androi id/button" 
android:text-"get value of edittext" 
/> 
</LinearLayout> 


在 上 述 代码 中 ， 将 系统 自 带 的 TextView 的 id 设置 为 text， 程 序 代 码 “android:textSize="20sp"” 和 “android:textColor= "stffffOfff"" 分别 上 
关 文 件 来 取得 等 号 后 面 的 值 。 接 下 来 的 代码 添加 了 EditText 和 Button。 


在 activityjava 里 声明 TextView、EditText 和 Button 三 个 控件 的 对 象 与 之 对 应 。 然 后 添加 Button 响 应 函数 ， 其 程序 代码 如 下 : 


private Button.OnClickListener edit view button listener = new Button.OnClickListener () { 


public void onClick(View v) { 
text.setText (edittext.getText () ) 7 
H 


上 述 程序 代码 就 是 在 Button 响 应 函数 里 获取 EditText 的 值 ， 并 把 这 个 值 在 TextView 上 显示 。 


接 下 来 在 onCreate 函 数 中 添加 控件 与 Button 响 应 函数 对 应 ,程序 代码 如 下 : 


设置 字体 大 小 和 字体 颜色 ， 读 者 在 自 


fun 


{Mz 


置 时 可 以 查 相 


button= (Button) findViewById (R.id.button) ; 
text- (TextView) findViewById (R.id.text) ; 


edittext- (EditText) findViewById (R.id.edittext); 
button.setOnClickListener(edit view button listener); 


运行 Android 程 序 ， 效 果 如 图 2-26 至 图 2-28 所 示 。 


get value of edittext 


2-26 


程序 运行 界面 


ИП] ЄЗ 2:18 AM 


hello.teday is a nice day! 


pet value of edittext 


Enittext 


nello.today is a nice day! 


get value af edittext 


EditText 控 件 在 应 用 程序 中 的 主要 作 


就 是 让 


户 输入 信息 ， 以 供 其 他 程序 使 


。 通 过 对 如 何 使 


Hl ЖЗ 2:19 AM 


2-27 在 EditText 里 输入 信息 


ИП &3 2:19 AM 


12-28 ”获取 EditText 中 的 信息 并 显示 到 TextView 上 


和 操作 EditText 控 件 的 讲解 ， 读 者 应 该 基本 掌握 了 EditText 控 件 。 


24.5 “多 项 选择 框 


与 EditText 类 似 ， 多 项 选择 框 (CheckBox) 也 是 读 取 用 户 输入 的 控件 ， 而 且 很 多 时 候 使 用 多 项 选择 框 要 比 用 户 直接 输入 方便 得 多 。 多 项 选择 框 一 般 提供 了 用 户 可 以 选择 的 选项 ， 可 以 一 次 选择 多 个 选 


项 。 


es) checkbox11. 2.5 
5-08 sre 
B www. google. cn 
: 由 -|| activityMain. java 
由 ыз gen [Generated Java Files] 
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88-025 drawable-hdpi 
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(=> drawable-mdpi 
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| Ej main. xml 
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default. properties 
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2-29 项 目 文 件 列表 


按照 图 2-29 所 示 项 目 文件 列表 创建 一 个 Android 项 目 。 与 其 他 控件 一 样 ， 也 是 在 XML 中 定义 ， 首 先 在 main.xml 文 件 中 添加 四 个 CheckBox 和 一 个 Button。 相 关 的 布局 文件 程序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android: id="@+id/text" 


android: textColor="#£fff0f0£" 
android: textSize="20sp" 
android: text="@string/hello" 
/> 
<CheckBox 
android: id="@+id/checkbox1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text 
{> 
<CheckBox 
android: id="@+id/checkbox2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"B" 
/> 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 


<Button 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:id="@+id/button" ~ 
android:text-"get value of checkbox" 
/> 

</LinearLayout> 


在 activityMainjava 文 件 中 声明 四 个 CheckBox 对 象 和 一 个 Button 与 之 对 应 ， 然 后 添加 Button 响 应 函数 ， 其 程序 代码 如 下 ; 


private Button.OnClickListener check_box_button_listener 
public void onClick (View у) { 
String it=""; 
if (checkbox1.isChecked () ) 
it=it+checkbox1.getText (); 
if (checkbox2.isChecked()) 
it=it+", "+checkbox2.getText () ; 
if (checkbox3.isChecked () ) 
it=it+", "+checkbox3.getText () ; 
if (checkbox4.isChecked()) 
it=it+", "+checkbox4.getText () ; 
text.setText (it); 
l 
1; 


new Button.OnClickListener () { 


和 图 


在 上 面 的 代码 中 ， 当 按 下 按钮 时 ， 监 听 函 数 将 判断 各 个 CheckBox 有 没有 被 选中 ， 然 后 把 选中 的 CheckBox 的 Text 值 取出 放 入 String 变 量 it 中 ， 最 后 将 it 的 值 在 TextView 中 显示 。 程 序 执行 效果 如 


2-31 所 示 。 


get value of checkbox 


图 2-30 ”执行 初始 界面 


中 | 


2-30 


图 2-31 点 击 按钮 获取 选择 的 值 


同 理 ， 在 其 他 应 用 中 可 以 获取 CheckBox 的 值 (或 是 只 判断 它 的 选中 状态 ) ， 然 后 把 这 些 值 交 给 系统 去 判断 ， 从 而 完成 应 用 程序 的 工作 。 


单项 选择 框 (RadioGroup) 控件 在 应 用 中 使 用 率 也 很 高 。 按 照 图 2-32 所 示 项 目 文件 列表 创建 一 个 Android 项 目 ， 与 其 他 控件 一 样 ， 首 先 在 main.xml 文 件 中 添加 一 个 RadioGroup， 在 这 个 RadioGroup 
中 加 入 四 个 RadioButton， 再 添加 一 个 Button。 相 关 的 布局 文件 程序 代码 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android: layout_widt fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android: id="@+id/text" J 
android:textColor="#ffff0f0f" 
android:textSize="20sp" 
android:text="@string/hello" 
/> 
<RadioGroup 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:orientation-"vertical" 
android: id="@+id/main"> 
<RadioButton 
android:text-"button one" 
android: id="@+id/button1" 
/> 
<RadioButton 
android: text="button_two" 
android: id="@+id/button2" 
{> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
</RadioGroup> 
<Button 
android: id="@+id/button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-"get value of radiogroup" 


/> 
</LinearLayout> 


在 activityMainjava 中 声明 以 上 控件 的 对 象 (RadioButton 控 件 对 象 不 用 添加 ) 与 之 对 应 ， 然 后 添加 如 下 Button 响 应 函数 的 程序 代码 : 


private Button.OnClickListener radio group button listener = new Button.OnClickListener () { 
public void onClick (View v) {text.setText ( ((RadioButton) findViewById (radiogroup.getCheckedRadioButtonId())) .getText () ) 7 
} 
F 
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图 2-32 项 目 文件 列表 


这 里 需要 仔细 体会 text.setText() 里 面 的 参数 。 在 上 述 代 码 中 ， 通 过 getCheckedRadio-Buttonld() 方 法 得 到 RadioGroup 中 被 选中 的 RadioButton 的 id， 再 把 这 个 id 放 入 findView-Byld 方 法 中 即 可 得 到 
这 个 RadioButton 对 象 ， 然 后 通过 读 取 RadioButton 的 getText() 方 法 得 到 text 值 ， 最 后 把 这 个 text 值 放 入 text.setText 中 显示 。 程 序 执行 效果 如 图 2-33 和 图 2-34 所 示 。 
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2-04 获取 选项 值 


下 拉 列 表 (Spinner) 在 触摸 屏 移 动 电话 上 比较 常用 ， 其 布局 节省 屏幕 空间 而 且 方 便 时 尚 。 根 据 图 2-35 所 示 项 目 文件 列表 创建 Android 项 目 。 


5 15 spinnerll.2.7 
m dh sre 
— BB www. google. en 
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* E gen [Generated Java Files] 
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2-35 项 目 文件 列表 


首先 在 main.xml 文 件 中 添加 一 个 Spinner 和 一 个 Button 并 给 自 带 的 TextView 添 加 id 和 显示 效果 。 相 关 的 布局 文件 程序 代码 如 下 : 


<TextView 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:textColor-"ffffOfOf" 
android:textSize-" "20sp" 
android:text-"spinner" 
android: id="@+id/text" /> 

<Spinner 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android: id="@+id/spinner"/> 

<Button 
android: id="@+id/button" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"get the value of spinner" 
/> 


接 下 来 在 activityMain.java 文 件 中 声明 以 上 各 个 控件 对 象 ， 然 后 为 Spinner 添 加 内 容 ， 添 加 方法 如 下 : 


private static String[] fruit-("Apple", "Banana", "Orange", "Pear", "Peach", "Grape", 
ArrayList«String» fruit name-new ArrayList<String>(); 

for(int i=0;i<fruit.length;it++) 

{ fruit _name.add(fruit[i]); } 

ArrayAdapter<String> adapter=new 

ArrayAdapter<String> (this,android.R.layout.simple spinner item,fruit name); 

adapter.setDropDownViewResource (android.R.layout.simple spinner dropdown item); 

spinner.setAdapter (adapter); 


Cherry"); 


在 上 述 程序 代码 中 ， 首 先 定义 了 一 个 字符 串 数 组 ， 将 需要 在 Spinner 控 件 上 显示 的 信息 存放 在 这 个 字符 串 数组 里 。 然 后 定义 了 一 个 ArrayList， 把 字符 串 数组 里 的 内 容 都 加 入 这 个 ArrayList 对 象 中 。 最 后 
以 这 个 ArrayList 对 象 为 参数 定义 一 个 ArrayAdapter 对 象 ， 把 这 个 Adapter 对 象 赋值 给 Spinner， 成 为 Spinner 的 数据 源 ， 到 这 里 就 完成 了 Spinner 的 资料 添加 过 程 。 


接 下 来 为 Button 添 加 响应 函数 ， 其 程序 代码 如 下 : 


private Button.OnClickListener button listener = new Button.OnClickListener () { 
public void onClick (View у) { 
text.setText (spinner.getSelectedItem().toString()); 
) 
u 


上 述 响 应 函数 是 通过 读 取 getSelectedltem() 来 得 到 Spinner 中 被 选中 的 选项 ， 然 后 把 这 个 选项 设置 为 text 并 显示 在 TextView 上 。 程 序 执行 效果 如 图 2-36 至 图 2-38 所 示 。 
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图 2-37 列表 展开 
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图 2-38 ”获取 选项 值 


除 以 上 介绍 的 Spinner 控 件 外 ，Android 还 提供 了 一 种 类 似 的 使 用 很 方便 的 辅助 输入 方式 AutoCompleteTextView， 其 特点 就 是 可 以 自动 完成 部 分 文本 输入 。 按 照 图 


2-39 所 示 项 


Android 项 目 。 


文件 列表 创建 一 个 
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图 2-39 项 目 文件 列表 


与 前 面 实现 其 他 控件 的 程序 设计 思路 一 样 ， 首 先 在 main.xml 文 件 里 添加 一 个 AutoCompleteTextView 和 一 个 Button， 相 关 的 布局 文件 程序 代码 如 下 所 示 : 


android:text="get the value of autocomplete" 


f= 


与 Spinner 相 同 ，AutoCompleteTextView 需 要 事先 添加 内 容 ， 添 加 方法 如 下 : 


fruit-("Apple", "Apple2", "Banana", "Orange", "Pear", "Peach", "Grape", "Cherry", "Apple3", "Banana2", "Orange2" "Pear2", "Peach2", "Grape2", "Cherry2", "Арр1іасаііоп"}; 
ArrayAdapter<String> adapter=new ArrayAdapter<String> (this, android.R.layout.simple_dropdown_item_1lline, fruit); 
autocomplete.setAdapter (adapter) ; 


在 上 面 程序 代码 中 ， 首 先 声明 一 个 String 数 组 ， 在 这 个 数组 里 存放 需要 添加 的 内 容 ; 然后 声明 一 个 适配器 对 象 adapter， 把 String 数 组 引入 这 个 adapter 中 ; 最 后 把 这 个 adapter 设 置 为 autocomplete 的 
Adapter。 


需要 通过 Button 来 过 滤 最 后 autocomplete 中 的 输入 值 ，Button 的 响应 函数 代码 如 下 : 


private Button.OnClickListener button listener = new Button.OnClickListener () { 
public void onClick (View у) { 
text.setText (autocomplete. getText () ) ; 
} 
F 


上 述 响 应 函数 读 取 autocomplete.getText() 方 法 获取 autocomplete 的 输入 值 ， 然 后 把 这 个 输入 值 显示 在 TextView 上 ， 如 图 2-40 至 图 2-42 所 示 。 


AutoCompleteTextView 的 自动 完成 功能 一 般 是 在 输入 2 个 字符 的 时 候 自 动 出 现 匹配 提示 列表 。 若 想 在 上 面 的 基础 上 进一步 学 习 ， 建 议 阅读 Android SDK 中 相关 的 内 容 。 
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autocompletetextview 


Hello World, activityMain! 


图 2-41 出 现 自动 提示 列表 
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图 2-42 ”获取 输入 值 


日 期 选择 器 (DatePicker) 和 时 间 选 择 器 (TimePicker) 控件 可 以 方便 地 对 日 期 和 时 间 进 行 设 置 ， 本 小 节 演示 如 何 通过 这 两 个 控件 设置 时 间 ， 并 且 为 程序 取得 设置 后 的 时 间 值 。 按 照 


图 


件 列表 创建 一 个 Android 项 目 。 
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2-43 项目 文件 列表 


首先 在 main.xml 文 件 中 添加 一 个 DatePicker、 一 个 Time-Picker、 一 个 TextView 和 一 个 Button， 相 关 的 布局 文件 程序 代码 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
> 


<DatePicker 
android: id="@+id/dp" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" 
/> 

<TimePicker 
android:id="@+id/tp" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" 
android: layout_below="@+id/dp" 


/> 

<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"üstring/hello" 
android: textColor="#£fff0f0£" 
android: textSize="18sp" 
android: id="@+id/text" 
android: layout_centerHorizontal="true 
android: layout_below="@+id/tp" 
/> 

<Button 
android: id="@+id/button" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true 
android: layout_below="@+id/text" 
android:text="get the value of above" 
/> 

</RelativeLayout> 


在 上 述 代码 中 用 到 了 RelativeLayout 布 局 ， 前 面 介绍 过 这 种 布局 ， 它 是 一 个 很 常见 并 且 使 用 方便 的 控件 ， 这 个 布局 文件 里 还 用 到 了 两 个 属性 ， 分 别 为 : 


android: layout_centerHorizontal="true" 
android: layout_below="@+id/" 


这 两 个 属性 分 别 表示 “水 平 居中 ”和 “ 某 控 件 下 方 ”的 意思 。 诸 如 此 类 的 相对 位 置 关系 在 其 他 布局 方法 中 很 难 精准 实现 ， 而 在 RelativeLayout 里 面 却 很 简单 ， 因 为 在 平时 的 应 用 程序 设计 中 会 大 量 使 用 
相对 布局 ， 所 以 RelativeLayout 布 局 方法 需要 熟练 掌握 。 


接 下 来 在 activityMain.java 文 件 中 添加 上 述 各 个 控件 对 象 与 之 对 应 ， 然 后 添加 Button 的 响应 函数 ， 程 序 代码 如 下 : 


private Button.OnClickListener button_listener=new Button.OnClickListener () { 
public void onClick (View ү) { 
text.setText (" 现 在 时 间 是 "+dp .getYear ()+" 年 "+ (dp.getMonth ()+1)+" 月 "+ 
dp.getDayOfMonth () +" H "+tp.getCurrentHour ()+" 点 "+tp.getCurrentMinute ()+"4") ; 
} 


H 


在 上 述 响 应 函数 中 完成 了 一 个 很 简单 的 操作 ， 首 先 读 取 选 择 器 的 getYear、getMonth、getDayOfMonth、getCurrentHour、getCurrentMinute 来 获取 和 
TextView 中 。 注 意 ， 之 所 以 在 getMonth 中 进行 了 加 1 操作 ， 是 因为 getMonth 取 得 的 月 份 信息 是 0~11， 比 真实 月 份 小 1， 这 里 加 上 1。 


п 
m 


日 、 时 、 分 钟 信息 ， 再 显示 在 


程序 执行 效果 如 图 2-44 和 图 2-45 所 示 。 


get the value of above | 


get the value of above 


图 2-45 ”获取 日 期 时 间 信 


进度 条 (ProgressBar) 是 个 非常 有 上 


项 目 。 


的 控件 ， 在 平时 的 程序 或 者 任务 的 执行 过 程 中 它 能 直观 地 反映 出 执行 进 | 


& 
总 


度 。 在 这 里 介绍 两 个 最 常见 的 Android 进 度 条 。 按 照 


2-46 所 示 项 目 文件 列表 创建 Android 


= = progressbarll.2.10 


ne des 


日 出 www. google. сп 
由 Ee (J) activityllain. java 


* iin gen [Generated Java Files] 
ES) Android 2. 1 

| e» assets 

= u> гек 


四 [^^ drawable-hdpi 
[2 drawable-ldpi 
(> drawable-mdpi 
Е [= layout 

Ч main. xml 
G [= values 


СЇ AndroidManifest. xml 
default. properties 


图 2-46 项目 文件 列表 


首先 在 main.xml 中 增加 两 个 ProgressBar 和 一 个 Button， 相 关 布 局 文件 程序 代码 如 下 所 示 : 


<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"8string/hello" 
android: textColor="#f£fff0f0£" 
android: textSize="20sp" 
android: id="@+id/text" /> 
<ProgressBar 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: id="@+id/progressbar1"/> 
<ProgressBar 
android: layout_width=" fill parent" 
android:layout height-"wrap « content" 
android: id=" @+id/progressbar2" 
android:max="100"/> 
<Button 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: id="@+id/button" 


android:text-" go " /> 


在 上 述 程序 代码 中 需要 注意 “style= "android:attVprogressBarStyleHorizontal"” 这 句 ， 它 是 控制 进度 条 为 水 平 模式 的 语句 。 


接 下 来 在 activityMain.java 文 件 中 添加 Button 响 应 函数 ， 其 程序 代码 如 下 : 


private Button.OnClickListener button_listener=new Button.OnClickListener () { 
public void onClick (View үу) { 
if (progressbar.getProgress ()«100) 
{ progressbar.setProgress (progressbar.getProgress () +5); 
text.setText (progressbar.getProgress ()*"$"); 
} 
else 
text.setText ("Done!") 7 
} 
1; 


在 上 述 响应 函数 中 ， 当 进度 条 未 满 时 ， 每 按 一 次 按钮 进度 加 5 并 在 TextView 上 显示 进度 ; 当 进 度 条 满 时 设置 TextView 显 示 “Done!”。 程 序 执行 效果 如 图 2-47 至 图 2-49 所 示 。 


Ш Э 2:25 АМ 


ШЧ 


progressbar 


图 2-48 ”显示 进度 


progressbar 


图 2-49 X “Done!” 


空 件 功能 相对 应 ， 它 就 是 可 以 被 拖 动 的 进度 条 。 按 
在 平时 的 操作 中 ， 经 常 要 手动 输入 一 个 值 来 直接 跳跃 进度 ， 例 如 播放 器 上 的 进度 条 ，Android 系 统 中 的 拖 动 条 (SeekBar) 控件 与 水 平 的 ProgressBar 控 件 功能 相对 应 ， 它 就 是 可 以 被 拖 动 的 进度 条 
在 平时 的 指 ， 经 | 


图 2-50 所 示 项 目 文件 列表 创建 Android 项 目 。 
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图 2-51 添加 图 片 文件 


首先 在 main.xml 中 放置 一 个 SeekBar 并 为 系统 自 带 的 Text-View 添 加 id 和 显示 效果 ， 相 关 的 布局 文件 程序 代码 如 下 所 示 : 


<TextView 


<SeekBar 
android: id="@+id/seekbar" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:max-"100" Е 
android: thumb="@drawable/seekbar"/> 


请 注意 上 述 代 码 的 最 后 一 句 “android:thumb= "@drawable/seekbar””， 它 的 作用 是 为 SeekBar 的 按钮 添加 显示 图 片 ， 所 以 应 该 事先 在 项 目 文件 夹 的 res/drawable-hdpi/ 下 面 添加 合适 的 
为 “seekbar. 格 式 扩展 名 ”， 添 加 成 功 后 可 以 在 项 目 文件 列表 中 看 到 如 图 2-51 所 示 信 息 。 


中 | 


片 并 命 


接 下 来 在 activityMainjava 文 件 中 的 操作 和 前 面 的 实验 类 似 ， 不 同 的 是 这 里 引入 了 SeekBar 的 一 个 拖 动 响应 函数 ， 声 明 部 分 的 代码 如 下 : 


private SeekBar.OnSeekBarChangeListener seekbar listener = new SeekBar.OnSeekBarChangeListener () { 
public void onProgressChanged (SeekBar seekBar, int progress, 
boolean fromUser) { 
// TODO Auto-generated method stub 
text.setText (seekbar.getProgress ()*"$"); 
) 
public void onStartTrackingTouch (SeekBar seekBar) { 
// TODO Auto-generated method stub 
} 
public void onStopTrackingTouch (SeekBar seekBar) { 
// TODO Auto-generated method stub 
} 
1; 


在 上 面 程序 代码 中 ， 只 在 onProgressChanged 函 数 中 添加 了 具体 操作 ， 即 取得 SeekBar 的 进度 并 把 它 显示 到 TextView 上 。 这 样 一 来 只 要 拖 动 进度 条 ， 进 度 值 就 会 实时 显示 在 TextView 上 。 程 序 执行 时 
的 显示 效果 如 图 2-52 和 图 2-53 所 示 。 


图 2-52 ЅеекВаг 


图 2-53 ”进度 显示 


2412 ”图 片 视图 


НП 2:27 AM 


接 下 来 介绍 的 是 图 片 视 图 (ImageView) 控件 ， 其 主要 用 于 展示 图 片 ， 使 用 非常 普遍 。 按 照 如 图 2-54 所 示 项 目 文件 列表 建立 Android 项 目 。 


ImageView 控 件 在 单独 使 用 的 时 候 用 法 非常 简单 ， 多 数 情 况 下 它 是 搭配 其 他 控件 一 起 使 用 的 ， 这 里 暂时 只 展示 它 的 图 片 显示 功能 。 首 先 在 main.xml 中 添加 一 个 ImageView， 相 关 的 布局 文件 程序 代码 
如 下 所 示 : 
<ImageView 


android:layout width-"fill parent" 
android:layout height-"fill parent" 
android: id="@+id/imageview" 


/> 


接 下 来 在 activityMain.java 文 件 中 添加 ImageView 对 象 ， 在 项 目 文件 夹 的 res/drawable-hdpi/ 目 录 下 添加 一 个 命名 为 Image 的 图 片 ， 


接 下 来 在 onCreate 函 数 中 添加 一 句 “imageview.setlImageResource(R.drawable.image);”， 它 的 作 


D 


添加 后 项 目 文件 列表 如 图 2 


是 为 ImageView 控 件 添加 图 


-55 所 示 。 


片 源 ， 执 行程 序 的 效果 如 图 


2-56 所 示 。 
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| mageview 


Hello World, activityMain! 


图 2-56  ImageView J t 


2443 ”基于 网 格 索引 的 图 片 浏览 器 


GridView 的 视图 大 家 肯定 不 陌生 ， 就 像 很 多 移动 电话 上 自 带 的 图 片 索引 浏览 功能 一 样 ，GridView 就 是 把 图 片 全 都 缩小 后 以 网 格 的 形式 展示 。 本 小 节 要 做 的 是 一 个 网 格 索引 图 片 、 点 击 后 放大 显示 的 简单 
司 片 浏览 器 。 按 照 图 2-57 所 示 项 目 文件 列表 创建 Android 项 目 。 


= gridyrewl1.2.13 
=| (A sre 
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由 П activityllain. java 
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在 main.xml 文 件 中 添加 一 个 GridView 和 一 个 ImageView， 相 关 的 布局 文件 程序 代码 如 下 所 示 :: 


ndroid.com/apk/res/android" 


android: gravity="center" 
android: id="@+id/gridview" 
/> 

<ImageView 
android: layout_x="0px" 
android: layout_y="0px" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android: id="@+id/imageview" 
android:visibility="invisible" 


/> 
</AbsoluteLayout> 


AbsoluteLayout 是 一 种 程序 设计 人 员 完 全 自由 定制 的 布局 方法 ， 控 件 布局 中 经 常 要 用 到 诸如 “android:layout_x= "0px"”” 和 “android:layout у= "0px"” 这 样 的 语句 ， 它 的 意思 是 该 控件 View 区 域 开 


始 于 哪 一 坐标 ， 这 里 采用 的 坐标 系 原点 位 于 左上 方 并 且 向 右 向 下 延伸 。 在 GridView 中 
7х, “android:horizontalSpacing="10dip"” 和 “android:verticalspacing= "10dip"” 是 指 每 张 索 引 之 间 的 空间 间距 为 10 像 素 。 
分 别 是 指 View 周 围 填 充 10 像 素 和 每 个 图 片 索 引 位 于 各 自 View 中 间 。 在 ImageView 中 上 


的 “android:numColumns="3"” 是 指 图 片 分 为 3 列 显 


“android:padding="10dip"” 和 “android:gravity= "center"”” 这 两 句 
到 这 一 句 “android:visibility= "invisible"” 的 意思 是 指 该 View 不 可 见 ， 这 是 暂时 将 它 隐藏 的 做 法 。 


在 activityMainjava 文 件 中 声明 相关 控件 对 象 ， 为 了 给 GridView 添 加 图 片 源 ， 这 里 需要 读者 自己 创建 一 个 ImageAdapter 公 开 类 来 做 GridView 的 适配器 并 为 其 提供 图 片 源 。 这 个 公开 类 的 创建 方法 在 后 


面 内 容 中 经 常用 到 ， 接 下 来 详细 介绍 一 下 。 


1) 右 击 项 目 文件 列表 中 的 src， 弹 出 如 图 2-58 所 示 菜单 ， 点 击 “Class”。 


New 


48 


ss aa 


2) 在 弹出 的 如 图 2-59 所 示 的 新 建 Java 类 窗口 


ImageAdapterjava， 如 图 2-60 所 示 。 


Go Into 


Open in New Window 
Open Type Hierarchy 
Show In 


Copy 
Copy Qualified Name 


中 点 击 “Source folder” 后 面 的 “Browse” 按 钮 ， 选 择 正确 的 包 名 并 填写 类 名 后 点 击 “Finish” 按 钮 ， 建 立 完成 后 ， 可 以 在 项 


Alt+Shift+w > (Sj Class - 
Ky Interface 
($ Enum 
(3^ Annotation 
$I Source Folder 


图 2-58 选择 新 建 类 


文件 列表 中 看 到 


© Нет Java Class 


Java Class 


Create a new Java class. 


O Enclosing type: [| vl | 
Name: ImageAdepter] sid 


Modifiers: (9 public C) default 
[Г] abstract L] final 


superclass: 


Interfaces: 


Which method stubs would you like to create? 
[ ]public static void mainíString[] args) 
| ]Censtructors from superclass 
[V] Inherited abstract methods 
Do you want to add comments? (Configure templates and default value here) 
[ ]Generate comments 


@ 


2-59 ”新建 Java 类 窗口 


gzridviewll.2.13 


-EŠ sre 
= 1+} www. google. cn 


ш П activityllain. java 


П ImazeAdapter. 


gen [Genera 


W 


2-60 ”完成 新 建 类 


接 下 来 打开 这 个 ImageAdapter.java 文 件 ， 在 其 中 添加 如 下 程序 代码 : 


package www.google.cn; 
import android.content.Context; 
import android.view.View; 
import android.view.ViewGroup; 
import android.Widget .BaseAdapter; 
import android.Widget .GridView; 
import android.Widget.ImageView; 
public class ImageAdapter extends BaseAdapter( 
private Context mContext; 
public ImageAdapter (Context m) 
{ mContext=m; } 
public int getCount() { 
// TODO Auto-generated method stub 
return mThumbIds.length;) 
public Object getItem(int position) { 
// TODO Auto-generated method stub 
return null; } 
public long getItemId(int position) { 
// TODO Auto-generated method stub 
return 0; } 
public View getView(int position, View convertView, ViewGroup parent) { 
// TODO Auto-generated method stub 
ImageView imageview; 
if(convertView--null) {imageview=new ImageView (mContext) ; 
imageview.setLayoutParams (new GridView. LayoutParams (85,85) ) ; 
imageview.setScaleType (ImageView.ScaleType.CENTER CROP); 
imageview.setPadding(8, 8, 8, 8); 
Jelse(imageview- (ImageView)convertView;] 
imageview. set ImageResource (mThumbIds [position]); 
return imageview; 
} 
static Integer[] mThumbIds={ 
.drawable.aa,R.drawable.bb,R.drawable.cc, 
. drawable.dd,R.drawable.e,R.drawable.f, 
.drawable.g,R.drawable.h,R.drawable.i, 
.drawable.j,R.drawable.k,R.drawable.l, 
.drawable.m,R.drawable.n,R.drawable.o, 
.drawable.p,R.drawable.q,R.drawable.r, 
.drawable.s, 


TAWWUWWUNM 


在 上 述 代码 中 ， 主 要 函数 为 View getView， 它 负责 从 mThumblds 中 获取 图 片 ， 并 用 图 片 生成 ImageView 后 返回 给 GridView。 接 下 来 设置 ImageView 的 显示 属性 ， 程 序 代码 如 下 : 


imageview.setLayoutParams (new GridView.LayoutParams (85, 85) )7 
imageview.setScaleType (ImageView.ScaleType.CENTER CROP); 
imageview.setPadding(8, 8, 8, 8); 


针对 ImageView 的 显示 属性 的 设置 非常 丰富 多 样 ， 读 者 可 自行 查看 Android SDK 文 件 了 解 。 接 下 来 看 看 mThumblds 数 组 ， 其 中 的 内 容 就 是 提前 放 入 /res/drawable/ 里 的 图 片 ， 如 图 2-61 所 示 。 
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2-61 提前 添加 图 片 文 件 


在 activtyMain.java 文 件 中 引用 新 建 的 ImageAdapter 类 ， 把 它 设置 为 GridView 的 适配器 ， 程 序 代 码 如 下 : 


gridview.setAdapter (new ImageAdapter (this)); 


到 这 里 只 是 给 GridView 添 加 好 图 片 源 而 已 ， 而 浏览 器 要 求 点 击 索 引 放 大 显示 图 片 ， 为 了 实现 这 个 功能 ， 还 要 在 activityMainjava 中 添加 点 击 响应 函数 ， 其 程序 代码 如 下 : 


private ImageView.OnClickListener image listener-new ImageView.OnClickListener () { 
public void onClick(View v) ( 
Й TODO Auto-generated method stub 
imageview.setVisibility (ImageView. INVISIBLE) ; 


gridview.setVisibility (GridView. VISIBLE) ; 


} 
H 


private GridView.OnItemClickListener listener-new GridView.OnItemClickListener () { 
public void onItemClick (AdapterView<> arg0, View argl, int arg2, 


long arg3) 


{ 


// TODO Auto-generated method stub 
imageview. set ImageResource (ImageAdapter .mThumbIds [arg2]) ; 
imageview.setVisibility (ImageView. VISIBLE) ; 
gridview.setVisibility (GridView. INVISIBLE) ; 


} 
1; 


在 上 述 程序 代码 中 ，OnltemClickListener( 完 成 单 击 索 引 放 大 显示 | 


D 


程序 执行 效果 如 图 2-62 至 | 


到 2-65 所 示 。 


片 的 功能 ， 而 Image-View.OnClickListener() 的 功能 是 恢复 网 格 显 示 。 
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2-64 放大 显示 图 片 


因为 智能 移动 设备 的 操作 会 受 限 于 屏幕 的 尺寸 ， 所 以 不 提倡 在 一 个 Activity 中 显示 过 多 的 元 素 。 比 较 简单 的 解决 办 法 是 将 一 个 Activity 拆 分 成 多 个 ， 每 个 部 分 都 单独 读 取 。 尽 管 这 样 解 决 了 表面 问题 ， 但 
是 却 出 现 了 额外 的 麻烦 ， 尤 其 是 针对 某 些 内 聚 属性 较 高 的 操作 ， 这 样 会 降低 操作 的 流畅 性 。 


这 里 介绍 一 种 比较 “温馨 ”的 解决 方法 ， 应 用 选项 卡 (TabHost) 控件 将 多 个 Activity 合 并 成 一 个 ， 这 样 就 可 以 同时 解决 两 个 问题 : 避免 单一 Activity 包 含 过 多 元 素 而 过 于 腑 肿 : 也 解决 了 将 复杂 的 拆 分 
后 ， 降 低 了 拆 分 “ 强 内 聚 ”而 影响 到 系统 的 整体 性 。 按 照 图 2-66 所 示 项 目 文件 列表 建立 Android 项 目 。 


gridview 
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图 2-66 ”项目 文件 列表 


在 main.xml 中 添加 三 个 TextView， 相 关 的 布局 文件 程序 代码 如 下 : 


android:background="#fffffff£" 
/> 


在 activityMain.java 文 件 中 声明 上 述 3 个 控件 对 象 ， 还 要 为 TabActivity 添 加 内 容 ， 其 程序 代码 如 下 : 


public class activityMain extends TabActivity { 
TabHost tab; 
/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle savedInstanceState) { 

super.onCreate (savedInstanceState); 

tab-getTabHost () ; 

LayoutInflater.from(this).inflate(R.layout.main, tab.getTabContentView(),true); 
tab.addTab (tab.newTabSpec ("tabl").setIndicator ("tab1") .setContent (R.id.text1) ); 
tab.addTab (tab.newTabSpec ("tab2") .setIndicator ("tab2") .setContent (R. id.text2)); 
tab.addTab (tab.newTabSpec ("tab3") .setIndicator ("tab3") .setContent (R. id.text3)); 
} 


在 上 述 程序 代码 中 ， 首 先 getTabHost 从 TabActivity 上 获取 放置 Tab 的 TabHost， 然 后 设置 布局 关联 。 其 中 ，tab.addTab 是 为 tab 添 加 新 tab 的 标识 信息 和 显示 内 容 。 
程序 执行 效果 如 图 2-67 所 示 。 


tabview 


2-67 TabView 执 行 效果 


24.15 列表 


在 Android 系 统 中 ，ListView 用 来 显示 一 个 列表 控件 。 按 照 图 2-68 所 示 的 项 目 文件 列表 建立 Android 项 目 。 其 中 放置 了 一 个 ListView 列 表 并 设计 了 两 个 事件 Listener 和 
OnltemselectedListener，Listener 事 件 是 鼠标 的 滚轮 转动 时 所 选 的 值 ; OnltemClickListener 事 件 则 是 当 鼠 标点 击 时 所 触发 的 事件 。 
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2-68 项 目 文件 列表 


my simple list_item.xml 文 件 自 定义 适用 于 ListView 的 Layout， 程 序 代码 如 下 : 


Colorxm| 是 定义 颜色 的 文件 ， 程 序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
<drawable name="black">#000000</drawable> 
<drawable name: hite">#FFFFFFFF</drawable> 
<drawable name="blue">#0000FF</drawable> 
<drawable name="1tgray">#CCCCCC</drawable> 
</resources> 


在 activityMainjava 文 件 中 添加 响应 函数 ， 其 主要 程序 代码 如 下 : 


m LinearLayout.setOrientation (LinearLayout.VERTICAL); 
m LinearLayout.setBackgroundColor (android.graphics.Color.WHITE) ; 
text - new TextView(this); 
LinearLayout.LayoutParams paraml = new LinearLayout.LayoutParams ( 
LinearLayout.LayoutParams.FILL PARENT, 
LinearLayout.LayoutParams.WRAP CONTENT); 
text.setText (R.string.title); 
text.setTextColor (getResources () .getColor (R. drawable.blue)); 
m LinearLayout.addView (text, paraml); 
m ListView = new ListView(this); 
LinearLayout.LayoutParams param2 = new Linearlayout.LayoutParams( 
LinearLayout.LayoutParams.FILL PARENT, 
LinearLayout.LayoutParams.WRAP CONTENT); 
m ListView.setBackgroundColor (getResources () .getColor (R.drawable.ltgray)); 
m LinearLayout .addView(m ListView, param2); 
setContentView m LinearLayout); 
ArrayAdapter<String> adapter = new ArrayAdapter«String» (this, 
R.layout.my simple list item, city); 
m ListView.setAdapter (adapter); 
m ListView .setOnItemSelectedListener (new AdapterView.OnItemSelectedListener () ( 
GOverride 
public void onItemSelected (AdapterView<> arg0, View argl, int arg2,long arg3) 
{ 
text.setText ("4 


Vw: " + argO0.getSelectedItem().toString()); 
} 

@Оуегг1де 

public void onNothingSelected (AdapterView<> arg0) 

{ // TODO Auto-generated method } 

DE 

m ListView.setOnItemClickListener (new AdapterView.OnItemClickListener () 


{ @Override 
public void onItemClick (AdapterView<> arg0, View argl, int arg2,long arg3) { 
text.setText ("Fit 市 是 : " + city[arg2]); 


在 上 述 程序 代码 中 ， 首 先 创建 一 个 LineaLayout 对 象 和 一 个 ListView 对 象 ，LineaLayout 用 来 显示 ListView。 在 添加 ArrayAdapter 时 ， 使 用 ArrayAdapter(Context context,int textView- 
Resourceld,T[lobjects) 这 个 构造 器 ， 其 中 textViewResourceld 是 定义 在 “resNlayout\my simple list_item.xml” 里 的 资源 ResourcelD (R.layout.my simple list item) ， 其 中 所 使 用 的 组 件 为 
CheckedTextView， 这 样 OnltemClickListener 才 可 获取 User 在 ListView 中 选择 的 项 目 。 


上 述 程序 代码 示范 了 LinearLayout 对 象 ， 动态 地 将 TextView 与 ListView “附加 ” 进 原 有 的 Layout 布 局 当中 ， 代 码 语句 “LinearLayout.LayoutParams param1” 的 作用 是 创建 LayoutParams 物 件 
param1， 然 后 读 取 “m_LinearLayout.addView(text,param1)”， 将 param1 对 象 传 入 ， 达 到 动态 配置 TextView 的 结果 ， 执 行程 序 的 效果 如 图 2-69 至 图 2-71 所 示 。 


2-69 ”程序 执行 主 界面 
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图 2-70 使 用 鼠标 滚动 界面 
 # 1:42 AM 
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A271 使 用 鼠标 点 击 界面 


Android 系 统 中 还 有 一 种 可 以 变换 背景 图 片 的 按钮 image-Button。 下 面 简单 地 介绍 如 何 使 用 ImageButton。 按 照 如 图 2-72 所 示 项 目 文件 列表 建立 Android 项 目 。 


(88 src 
= www. google. сп 
由 -| 用 activityllain. java 


35-08 геп [Generated Java Files] 


E Android 2.1 


: Es assets 


= 1 res 
=i drawable-hdpi 
~) button. png 
ЫЈ 1соп. png 
+ drawable-ldpi 
L^» drawable-mdpi 
Ы layout 
Ej main. xml 
H- values 


一 图 AndroidManifest. xml 


default. properties 


2-72 项 目 文件 列表 


在 main.xml 中 添加 一 个 TextView 和 一 个 ImageButton， 相 关 的 布局 文件 程序 代码 如 下 : 


android:orientation="vertical" 


<TextView 


android: id="@tid/text" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:text-"8string/hello" 
/> 
<ImageButton 
android: id="@+id/ImageButton01" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:src-"(drawable/button" 
/> 


</LinearLayout> 


在 项 目 文件 列表 的 res/drawable-hdpi/ 目 录 下 添加 一 个 命名 为 button 的 


button 的 图 片 。 


本 实现 主要 通过 setlmageDrawble 方 法 来 改变 按钮 的 


网 


F, 


[D 


F. 


要 程序 代码 如 下 : 


“android:src="@drawable/button"” 这 句 代 码 表示 将 ImageButton 的 背景 


片 指定 为 drawable-hdpi 里 面 ID 号 为 


private Button.OnClickListener button listener = new Button.OnClickListener () { 


public void onClick (View v) 


{ m_ImageButton1.setImageDrawable (getResources () .getDrawable (R.drawable.icon) ) ; 


text.setText ("this is ImageButton"); } 
1; 


执行 程序 效果 如 图 2-73 和 图 2-74 所 示 。 


24.17 nuum 


Android 系 统 中 有 一 个 跟 iOS 系 统一 样 ， 可 以 用 手指 来 拖 动 


D 


片 产生 | 


D 


В. 


片 移动 效果 的 控件 ， 就 是 Gallery。 下 面 通过 一 个 简单 的 实验 来 讲解 Gallery 的 


2-73 


程序 执行 主 界面 


法 。 按 照 


IR] 


2-75 所 示 项 目 文件 列表 建立 Android 项 
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Imageoutton 
this is [mage Button 
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在 main.xml 中 添加 一 个 TextView 和 一 个 Gallery。 相 关 的 布局 文件 程序 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android="http: //schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android:layout height-"fill parent" > 
<TextView 
android: id="@+id/text" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:text-"Gstring/hello" /> 
«Gallery 
android: id="@+id/gallery" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:gravity-"bottom" 7> 
</LinearLayout> 


片 预 先 存放 于 项 目 文件 列表 的 res/drawable-hdpi/ 目 录 下 ，3 张 图 片 分 别 为 ajpg、bjpg 和 cjpg。 主 要 代码 如 下 : 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main); 
( (Gallery) findViewById (R.id.gallery)) 
.setAdapter (new ImageAdapter (this)); } 
public class ImageAdapter extends BaseAdapter 
{private Context myContext; 
private int[] myImage = ( R.drawable.a, 
R.drawable.b, 
R.drawable.c, }; 

public ImageAdapter (Context c) ( this.myContext = c; } 

public int getCount() { return this.myImage.length; } 

public Object getItem(int position) { return position; } 

public long getItemId(int position) { return position; } 

public View getView(int position, View convertView, 
ViewGroup parent) 

{ ImageView i = new ImageView(this.myContext) ; 
i.setImageResource (this.myImage [position] ); 
i.setScaleType (ImageView.ScaleType.CENTER); 
return i; } 


在 上 述 代码 中 ，Gallery 是 一 个 存放 所 要 显示 的 图 片 的 容器 ， 这 里 使 用 一 个 继承 自 BaseAdapter 类 的 派生 类 来 存放 这 些 图 片 。Context 在 Activity 中 扮演 的 角色 就 如 同一 张 Canvas 画 布 ， 可 以 随时 被 处 理 
或 覆盖 。 程 序 中 的 mylmage 是 存放 图 片 1D 的 int 型 数组 ， 然 后 通过 使 用 setlmageResource 的 方法 来 设置 ImageView 要 显示 的 图 片 资源 ， 最 后 将 图 片 的 ImageView 显 示 在 屏幕 上 。 程 序 代码 中 的 “public int 
getCount(){return this.mylmage.length;}” 这 句 用 于 获取 图 片 的 总 量 。 可 以 利用 getltem 方 法 取得 目前 容器 中 图 像 数组 的 ID， 执 行程 序 效果 如 图 2-76 和 图 2-77 所 示 。 


中 | 
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2-76 执行 程序 主 界面 


A2-77 切换 图 片 


通过 前 面 这 些 篇 幅 ， 介 绍 了 一 些 常用 的 Widget 控 件 。 通 过 这 些 控件 的 学 习 ， 读 者 应 该 基本 掌握 了 布局 、 控 件 和 事件 响应 原理 ， 以 及 Android 开 发 过 程 中 项 目 文件 的 管理 方法 等 。 在 本 章 的 学 习 过 程 中 应 
该 尽 可 能 亲手 实践 ， 为 以 后 Android 的 学 习 打 好 基础 。 各 个 控件 的 接口 、 功 能 事件 以 及 系统 环境 提供 的 接口 方法 有 很 多 ， 可 以 参照 Android SDK 文 件 加 深 了 解 。 


2448 ”对 话 框 实例 


随 着 硬件 设备 功能 的 日 益 强 大 和 用 户 接 口 人 性 化 的 提高 ， 在 应 用 程序 中 用 户 与 设备 之 间 的 交流 和 信息 的 传递 越 来 越 离 不 开 对 话 框 的 帮助 。 虽 然 对 话 框 在 程序 中 不 是 必 备 的 ， 但 是 使 用 对 话 框 可 以 增强 应 
的 友好 性 。 例 如 用 户 登录 、 提 示 信 息 、 事 件 提示 、 任 务 状态 等 很 多 场景 都 可 以 用 到 对 话 框 ， 因 此 对 话 框 的 使 用 也 是 一 项 应 用 开发 的 必要 技能 。 
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按照 图 2-78 所 示 项 目 文件 列表 创建 Android 项 目 ， 其 中 alarm.png 和 entry.xml 需 要 手动 添加 。 


在 main.xml 文 件 中 ， 添 加 三 个 Button， 分 别 


于 显示 信息 提示 对 话 框 、 


输入 对 话 框 和 进度 对 话 框 。 相 关 的 布局 文件 程序 代码 如 下 : 


<Button 
android: id="@+tid/button1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 


:text="Info Prompt Box" 


<Button 
android: 
android: 
android: 
android: 

/> 

<Button 

android: 


id="@+id/button2" 
layout_width="fill_parent" 
layout height-"wrap content" 
text-"Entry Dialog Box" 


id="@+id/button3" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Progress Dialog Box" 


/> 


在 activityMainjava 中 添加 Button 的 时 间 响 应 函数 ， 其 程序 代码 如 下 : 


private static final int DIALOGI = 1; 
private static final int DIALOG2 
private static final int DIALOG3 


private Button.OnClickListener buttonl listener-new Button.OnClickListener () { 


public void onClick (View v) { 
showDialog (DIALOG1) ; 

} 

i 


private Button.OnClickListener button2_listener=new Button.OnClickListener () { 


public void onClick (View v) { 
showDialog (DIALOG2) ; 

} 

}; 


private Button.OnClickListener button3_listener=new Button.OnClickListener () { 


public void onClick (View v) { 
showDialog (DIALOG3) ; 
} 

H 


在 上 述 代码 中 ， 三 个 Button 分 别 在 点 击 响应 中 通过 showDialog 启 动 三 种 不 同类 型 的 对 话 框 ， 这 里 的 showDialog 会 首先 判断 带 入 的 参数 ， 然 后 再 去 读 取 onCreateDialog(int id)fflonPrepareDialog(int 


id,Dialog dialog). onCreateDialog(int id) 负 责 创建 对 话 框 ， 而 onPrepareDialog(int id,Dialog dialog 256! 
showDialog 读 取 ， 而 onPrepareDialog 每 次 都 会 被 showDialog 读 取 。onCreateDialog(int id) 的 程序 代码 如 下 : 


好 的 对 话 框 在 显示 以 前 再 做 修改 。onCreateDialog 只 有 在 新 创建 一 个 对 话 框 时 才 被 


GOverride 
protected Dialog onCreateDialog(int id) ( 
switch (id) ( 
case DIALOGl: 
return buildDialogl (activityMain.this); 
case DIALOG2: 
return buildDialog2 (activityMain.this); 
case DIALOG3: 
return buildDialog3 (activityMain.this); 
} 
return null; 
} 

private Dialog buildDialogl (Context context) { 
AlertDialog.Builder builder = 
builder. 
builder. 
builder 
builder.setPositiveButton ("OK", null); 
builder.setNegativeButton ("Cancel", null); 
return builder.create(); 
} 
private Dialog buildDialog2 (Context context 
LayoutInflater inflater = 
final View EntryView = inflater.inflate( 
AlertDialog.Builder builder = 
builder.setTitle ("entry"); 
builder.setView (EntryView); 
builder.setPositiveButton ("OK",null); 
builder.setNegativeButton ("Cancel",null); 
return builder.create(); 


} 


setiIcon (R.drawable.alarm) ; 
setTitle ("Prompt Inf"); 


new AlertDialog.Builder (context) ; 


.setMessage ("hello welcome to use this software"); 


Lg 


LayoutInflater.from(this); 


R.layout.entry, null); 


new AlertDialog.Builder (context); 


private Dialog buildDialog3 (Context context) { 


ProgressDialog progress - 
progress.setTitle ("system is busy"); 


new ProgressDialog (context); 


progress.setMessage ("please waitinghttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/. .http: / /www.hzcourse.com/resour 


return progress; 


} 


过 “builder.setlcon(R.drawable.alarm);” 一 句 代码 设置 医 
个 是 按钮 响应 方法 ， 这 里 省 略 了 响应 方法 ， 都 为 null。 不 同 


在 上 述 代码 中 ，onCreateDialog(int id) 触 发 额外 定义 | 


的 buildDialog 去 创建 对 话 框 ， 在 前 两 个 buildDialog 中 使 


in, F 


AlertDialog.Builder 对 象 ， 在 这 个 对 象 里 添 


setMessage 设 置 对 话 框 显示 信息 ，setPositiveButton 和 setNegativeButton 是 为 对 话 框 添加 按钮 ， 
的 是 ， buildDialog2 中 还 读 取 setView 来 为 对 话 框 引入 R.layout.entry 这 个 布局 ， 


R.layout.entry 这 个 布 


Title 设 置 动 作 ， 通 


局 需要 读者 自行 添加 ， 


中 的 参数 一 个 是 按钮 的 Text， 另 一 


其 程序 代码 如 下 : 


<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"user name" ~ 
/> 

<EditText 
android: id="@+tid/user" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 

/> 

<TextView 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:text-"password" 
/> 

<EditText 
android: id="@+id/password" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:password-"true Е 


/> 


在 上 述 代 码 中 ， 设 置 了 一 个 含有 


行 效果 如 图 2-79 至 图 2-82 所 示 。 


名 输入 框 和 密码 输入 框 的 


登录 接口 布局 。 


buildDialog3 中 创建 了 一 个 含 进度 条 的 对 话 框 ， 新 建 一 个 ProgressDialog 对 象 并 设置 其 Title 信 息 和 Message。 程 序 执 
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Entry Dialog Box 


Progress Dialog Box 
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Prompt Inf 


hello welcome to use this software 


2-80 信息 提示 对 话 杠 


password 


2-81 用 户 输入 对 话 框 
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(+) system is busy 


图 2-82 ”进度 对 话 框 


25 ”界面 布局 


界面 布局 (Layout) 是 用 户 界面 结构 的 描述 ， 定 义 了 界面 中 所 有 的 元 素 、 结 构 和 相互 关系 。 声 明 Android 程 序 的 界面 布局 有 两 种 方法 : 一 种 使 用 XML 文 件 描述 界面 布局 (推荐 使 用 ) ， 另 一 种 在 程序 运 
行 时 动态 添加 或 修改 界面 布局 。 既 可 以 独立 使 用 任何 一 种 声明 界面 布局 的 方式 ， 也 可 以 同时 使 用 两 种 方式 。 


使 用 XML 文件 声明 界面 布局 的 优势 在 于 将 程序 的 表现 层 和 控制 层 分 离 ， 修 改 用 户 界面 时 ， 无 需 更 改 程序 的 源 代码 ， 可 通过 Eclipse 的 “可 视 化 编辑 器 ”直接 查看 用 户 界面 ， 有 利于 加 快 界 面 设计 的 过 程 。 
的 6 种 界面 布局 包括 : 线性 布局 、 框 架 布局 、 表 格 布局 、 相 对 布局 、 绝 对 布局 、 网 格 布局 。 


ai 


Android 中 视图 按照 树 形 结构 进行 设计 (视图 树 ) ; 而 视图 树 由 View 或 ViewGroup 构 成 。Android 视 图 层次 结构 如 图 2-83 所 示 。View: 视图 控件 ， 界 面 可 操作 的 最 小 可 视 化 元 素 ; ViewGroup: 由 
View 或 ViewGroup 组 成 的 元 素 组 。 界 面 布局 如 图 2-84 所 示 。 


ViewGroup 


ViewGroup View 


2-83 Android 视 图 层次 结构 


ViewGroup0 


ViewGroup І 


View2 View3 


ViewGroup2 


ViewGroup3 


ViewGroup4 


图 2-84 ”界面 布局 


2.5.1 线性 布局 


线性 布局 (LinearLayout) 是 一 种 重要 的 界面 布局 ， 也 是 经 常用 到 的 一 种 界面 布局 。 在 线性 布局 中 ， 所 有 的 子 元 素 都 按照 垂直 或 水 平 的 顺序 在 界面 上 排列 。 如 果 垂 直 排 列 ， 则 每 行 仅 包 含 一 个 界面 元 
素 ; 如 果 水 平 排列 ， 则 每 列 仅 包含 一 个 界面 元 素 ， 如 图 2-85 和 图 2-86 所 示 。 


P LinearLayout 


P Linearl ayout 


APS: _ 确认 BGA 


图 2-86 ”水 平 排列 


1) 最 小 化 的 线性 布局 XML 文件 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http:// schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:orientation-"vertical"» 
</LinearLayout> 


在 上 述 代码 中 ， 声 明 XML 文 件 的 根 元 素 为 线性 布局 ， 在 文件 编辑 器 中 修改 宽度 、 高 度 和 排列 方式 的 属性 。 


2) 修改 界面 控件 的 属性 ， 具 体 属性 如 表 2-2 所 示 。 


表 2-2 界面 控件 属性 


编号 
Layout width 


1 TextView 


2 EditText 


3 Button 


4 Button 


1D 是 一 个 字符 串 ， 编 译 时 被 转换 为 整数 ， 可 以 用 来 在 代码 中 引用 界面 元 素 ， 一 般 仅 在 代码 中 需要 动态 修改 界面 元 素 时 ， 才 为 其 设置 ID， 反 之 则 不 需要 设 


3) 打开 XML 文件 编辑 器 查看 main_vertical.xml 文 件 代 码 : 


值 
@+id/label 
用 户 名 : 
@+id/entry 
fill parent 
[null] 
@+id/ok 
确认 
@+id/cancel 


取消 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmins:android="http:// schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"vertical"» 
<TextView android:id="@+id/label" 
android: layout width-"wrap content" 
android: layout_height="wrap_ content" 
android:text-"J] Р £:" > = 
</TextView> 
<EditText android:id="@+id/entry" 
android:layout_height="wrap_content" 
android:layout width="fill parent"> 
</EditText> 
«Button android: id="@+id/ok" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-' 58i "> Е 
</Button> 
«Button android:id="@+id/cancel" 
android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" JU" > 
«/Button» 
</LinearLayout> 


将 LinearLayout.java 文 件 中 的 setContentView(R.layout.main) 更 改 为 SetContentView(R.layout.main_vertical)。 运 行 后 的 结果 如 图 2-87 所 示 。 


4) 横向 线性 布局 。 建 立 main_horizontal.xml 文 件 ， 将 线性 布局 的 Orientation 属 性 的 值 设置 为 horizontal， 将 EditText 的 Layout width 属性 的 值 设置 为 wrap_content， 


setContentView(R.layout.main_vertical) 修 改 为 setContentView(R.layout.main_horizontal)， 如 图 2-88 所 示 。 


将 LinearLayout.java 文 件 中 的 


P Linearl ayout 


用 户 名 


| 
确认 


P LinearLayout 


APS _ 确认 取消 


图 2-88 ”横向 线性 布局 


2.5.2 ”框架 布局 


框架 布局 (FrameLayout) 是 最 简单 的 界面 布局 ， 是 用 来 存放 一 个 元 素 的 空白 空间 ， 且 子 元 素 的 位 置 是 不 能 指定 的 ， 只 能 放置 在 空白 空间 的 左上 角 。 如 果 有 多 个 子 元 素 ， 后 放置 的 子 元 素 将 遮挡 先 放 置 


的 子 元 素 ， 使 用 Android SDK 中 提供 的 层级 观察 器 (Hierarchy Viewer) 进一步 分 析 界 面 布局 。 树 形 结构 图 和 界面 如 图 2-89 和 图 2-90 所 示 。 


PhoneWindow$DecorView 


#05 e 4 


LinearLayout 
#0@43599ee0 
NO ID 


FrameLayout 
#1@4359b858 
id/content 


LinearLayout 
#0@4359bd60 
NO_ID 


TextView EditText Button Button 


#0@4359bfa8 #1@4359c5f8 #2@4359d5d8 #3@4359de18 
id/tabel id/entry idjok id/cancel 


82-89 ” 树 形 结构 图 


FrameLayout 
#0@4359a730 
NO_ID 


TextView 
#0@4359ad18 
idititle 


p Toy ] 


px duy 4 


[X tay 5 


290 ”界面 图 


结合 界面 布局 的 树 形 结构 图 和 界面 图 ， 分 析 不 同 界面 布局 和 界面 控件 的 区 域 边界 。 用 户 界面 的 根 节点 (#0@43599ee0) 是 线性 布局 ， 其 边界 是 整个 界面 ， 也 就 是 界面 图 的 最 外 层 的 实心 线 。 


根 节点 右 侧 的 子 节点 (#0@43599a730) 是 框架 布局 ， 仅 有 一 个 节点 元 素 (#0@4359ad18) ， 这 个 子 元 素 是 TextView 控 件 ， 用 来 显示 Android 应 用 程序 名 称 ， 其 边界 是 示意 图 中 的 区 域 1。 因 此 框架 
布局 元 素 #0@43599a730 的 边界 同 区 域 1 的 高 度 相同 ， 宽 度 充满 整个 根 节点 的 区 域 。 这 两 个 界面 元 素 是 系统 自动 生成 的 ， 一 般 情况 下 用 户 不 能 修改 和 编辑 。 


根 节点 左 侧 的 子 节点 (#1@4359b858) 也 是 框架 布 


局 ， 边 界 是 区 域 2 到 区 域 7 的 全 部 空间 。 


子 节点 (#1@4359b858) 下 仅 有 一 个 子 节点 (#0@4359bd60) 元 素 是 线性 布局 ， 因 为 线性 布局 的 Layout width 属 性 设置 为 fill_parent，Layout height 属 性 设置 为 wrap_content， 因 此 该 线性 布局 的 


宽度 就 是 其 父 节点 #1@4359b858 的 宽带 ， 高 度 等 于 所 有 子 节点 元 素 的 高 度 之 和 。 


线性 布 


表格 布 


局 #0@4359bd60 的 四 个 子 节点 元 素 #0@4359bfa8、#1@4359c5f8、#2@4359d5d8 和 #3@4359de18 的 边界 分 别 是 图 2-90 中 的 区 域 2、 区 域 3、 区 域 4 和 区 域 5。 


局 (TableLayout) 是 一 种 常用 的 界面 布局 ， 通 过 指定 行 和 列 将 界面 元 素 添加 到 表格 中 。 网 格 的 边界 对 用 户 是 不 可 见 的， 表格 布局 支持 庶 套 ， 可 以 将 表格 布局 放置 在 表格 布局 的 表格 中 ， 也 可 以 


在 表格 布局 中 添加 其 他 界面 布局 ， 例 如 线性 布 


局 、 相 对 布 


局 等 。 表 格 布局 示意 图 如 图 2-91 所 示 ， 表 格 布局 效果 图 如 图 2-92 所 示 。 


Row | 


Row 2 


Text View EditText h 


291 表格 布局 示意 图 


2-92 表格 布局 效果 图 


ABl Task List 
H TableLayouto1 
Ed TableRow01 
Ab label (TextView) - "HIPS : " 
ни entry (EditText) 


НӘ] TableRow02 
= ok (Button) - "确认 " 
»- Button02 - "取消 " 


2-93 Жл 


Т) 在 界面 可 视 化 编辑 器 上 ， 向 TableRow01 中 拖 外 TextView 控 件 和 EditText 控 件 ， 如 图 2-93 所 示 。 


2) 在 界面 可 视 化 编辑 器 上 ， 再 向 TableRow02 中 拖 鬼 两 个 Button 控 件 。 参 考 表 2-3 设 置 TableRow 中 四 个 界面 控件 的 属性 值 。 


表 2-3 设置 界面 控件 的 属性 值 


1 TextView Gravity 


Padding 
Layout width 


Text 


Padding 


Layout width 


Padding 


Padding 


3) 建立 表格 布局 main.xml 文 件 的 完整 代码 如 下 : 


值 
@+id/label 
用 户 名 : 
right 
3dip 
160dip 
@+id/entry 
[null] 
3dip 
160dip 
@+id/ok 
确认 
3dip 
@-+id/cancel 
取消 
3dip 


<?xml version-"1.0" encoding-"utf-8"?» 
<TableLayout android:id="@+id/TableLayout01" 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android"» 
<TableRow android: id="@+id/TableRow01" 
android:layout width-"wrap content" 
android: layout_height="wrap_content"> 
<TextView android:id="@+id/Iabel" 
android: layout height-"wrap content" 
android: layout_width="160dip" 
android: gravity="right" 
android:text-"J]P Ж: " 
android:padding="3dip" > 
</TextView> 
<EditText android: id="@+id/entry" 
android: layout height-"wrap content" 
android: layout_width="160dip" 


android:padding="3dip" > 
</EditText> 
</TableRow> 
<TableRow android: id="@+id/TableRow02" 
android:layout width-"wrap content" 
android: layout_height="wrap_content"> 
«Button android: id="@+id/ok” 


android:layout height-"wrap content" 


android:padding-"3dip" 
android:text-" 4i "> 
«/Button» 
«Button android:id="@+id/Button02" 


android:layout width-"wrap content" 


android:layout height-"wrap content" 


android:padding-"3dip" 
android:text=" 取 消 "> 
</Button> 
</TableRow> 
</TableLayout> 


在 上 述 代 码 中 ,使 


了 <TableLayout> 标 签 声明 表格 布 


局 ， 声 明了 两 个 TableRow 元 素 。 设 定 宽度 


android:padding 声 明 TextView 元 素 与 其 他 元 素 的 间隔 距离 为 3dip。 


254 ”相对 布局 


相对 布局 (RelativeLayout) 是 一 种 非常 灵活 的 布局 方式 ， 能 够 通过 指定 界面 
界面 布局 。 
相对 布局 在 main.xml 文 件 的 完整 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<RelativeLayout android 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


属性 android:layout_ width:160dip， 设 定 


属性 android:gravity， 指 定 文字 为 右 对 齐 。 使 用 属性 


TRI 


他 元 素 的 相对 位 置 关 系 ， 确 定 界面 


中 所 有 元 素 的 布局 位 


。 能 够 最 大 程度 保证 在 各 种 屏幕 尺寸 的 手机 上 正确 显示 


@+id/RelativeLayout01" 


xmlns:android="http:// schemas.android.com/apk/res/android"> 


<TextView android:id="@+id/label" 
android:layout_height="wrap_content" 
android:layout width="fill parent" 
android:text=" 用 户 名 : "> 

</TextView> 

<EditText android:id="@+id/entry" 
android:layout height-"wrap content" 
android:layout width-"fill parent" 
android:layout below-"Qid/label"» 

«/EditText» Е 

<Button android: 


id="@+id/cancel" 


android:layout height-"wrap content" 


android: 
android: 
android: 
android: 
android: 
«/Button» 
«Button 
android: 
android: 
android: 
android: 
android: 
«/Button» 
«/RelativeLayout» 


layout width-"wrap content" 
layout alignParentRight-"true" 
layout marginLeft-"10dip" 
layout below-"Qid/entry" 
text=" 取 消 " > 


android: id="@+id/ok" 
layout_height="wrap_content" 
layout width-"wrap content" 
layout_toLeftOf="@id/cancel" 
layout_alignTop="@id/cancel" 
text=" 确 认 ">、 


在 上 述 代码 中 ,使 
元 素 在 其 父 元 素 的 右边 并 边界 对 齐 。 设 定 


2.5.5 ”绝对 布局 


了 <RelativeLayout> 标 签 声明 一 个 相对 布 


属性 android:layout_ alignTop 声 明 该 元 素 与 1D 为 cancel 的 元 素 在 相 


局 ， 使 用 位 


同 的 水 平 位 置 。 


属性 android:layout_below 确 定 EditText 控 件 在 ID 为 label 的 元 素 下 方 。 使 
属性 android:layout_marginLeft 左 移 10dip， 声 明 该 元 素 在 ID 为 entry 的 元 素 下 方 ， 使 


属性 android:layout toLeftOf 声 明 该 元 素 在 ID 为 cancel 元 素 的 左边 。 使 


属性 android:layout alignParent-Right 声 明 该 


绝对 布局 (AbsoluteLayout) 能 通过 指定 界面 元 素 的 坐标 位 置 来 确定 用 户 界面 的 整体 布局 。 不 推荐 使 用 绝对 布局 ， 因 为 通过 X 轴 和 Y 轴 确定 界面 元 素 位 置 后 ，Android 系 统 不 能 够 根据 不 同 屏幕 对 界面 元 
素 的 位 置 进行 调整 ， 降 低 了 界面 布局 对 不 同类 型 和 尺寸 的 屏幕 的 适应 能 力 。 每 一 个 界面 控件 都 必须 指定 坐标 (X, Y) ， 例 如 “确认 ”按钮 的 坐标 是 (40，120) ，“ 取 消 ”按钮 的 坐标 是 (120, 120), Ж 
标 原点 (0，0) 在 屏幕 的 左上 角 。 

绝对 布局 示例 的 main.xml 文 件 完整 代码 如 下 : 

<?xml version-"1.0" encoding-"utf-8"?» 

<AbsoluteLayout android @+id/AbsoluteLayout01" 


android: layout_width="fill parent" 

android:layout height-"fill parent" 

xmlns:android-"http 

<TextView android:id="@+id/label" 
android:layout 40dip" 
android:layout y-"40dip" 
android:layout height-"wrap content" 
android:layout width-"wrap content" 
android:text-"JH P Ж: "> 

</TextView> 

<EditText android:id="@+id/entry" 
android: layout_x="40dip" 
android: layout_y="60dip" 
android:layout height-"wrap content" 
android:layout width-"150dip"» 

«/EditText» 

«Button android:id="@+id/ok" 
android:layout width-"70dip" 
android:layout height-"wrap content" 
android:layout x-"40dip" ~ 
android:layout 120dip" 
android:text-" 3j] "> 

«/Button» 

«Button android:id="@+id/cancel" 
android:layout width-"70dip" 
android:layout height-"wrap content" 
android:layout x-"120dip" ~ 
android:layout 120dip" 
android: text=" 

</Button> 

</AbsoluteLayout> 


25.6 ”网 格 布局 


/ schemas.android.com/apk/res/android"> 


网 格 布局 (GridLayout) 将 用 户 界 


m 


划分 为 网 格 ， 界 


元 素 可 随意 摆 放 在 网 格 中 。 


H] 


网 格 布局 比 表格 布局 (TableLayout) GAM 


设计 上 更 加 灵活 ， 在 网 格 布 


元 素 可 以 占 


Sr 


多 个 网 格 ， 而 在 表格 


布局 却 无 法 实现 ， 只 能 将 界面 元 素 指定 在 一 个 表格 行 (TableRow) 中 ， 不 能 跨越 多 个 表格 行 。 


用 GroidLayoutDemo 示 例 说 明 网 格 布局 的 使 用 方法 。 


1) 在 Eclipse 界面 设计 器 中 的 界面 图 示 与 在 Android 模 拟 器 运行 后 的 用 户 界面 分 别 如 图 2-94 所 示 和 图 2-95 所 示 。 


在 界面 设计 器 中 可 以 看 到 虚线 网 格 ， 但 在 模拟 器 的 运行 结果 中 是 看 不 到 的 ， 网 格 布局 将 界面 划分 成 多 个 块 ， 这 些 块 是 根据 界面 元 素 动态 划分 的 。 具 体 地 讲 ，GroidLayoutDemo 示 例 的 左边 第 一 列 的 宽 
度 是 综合 分 析 在 第 一 列 中 的 两 个 界面 元 素 “ 用 户 名 ”和 “密码 ”TextView 的 宽度 而 设 定 的 ， 选 择 两 个 元 素 中 最 宽 元 素 的 宽度 作为 第 一 列 的 宽度 。 最 上 方 第 一 行 的 高 度 也 是 分 析 “ 这 是 关于 GridLayout 的 示 
例 ” 这 个 TextView 元 素 的 高 度 而 设 定 的 。 因 此 ， 网 格 布局 中 行 的 高 度 和 列 的 宽度 完全 取决 于 本 行 或 本 列 中 高 度 最 高 或 宽度 最 宽 的 界面 元 素 。 


这 是 关于 GroidLayout 的 示例 


Ра = == - : > = к === —] —À — {— 一 -一 - 


P GridLayoutDemo 


这 是 关于 GroidLayout 的 示例 


2) main.xml 文 件 的 全 部 代码 如 下 : 


2-95 


模拟 器 运行 结果 


<?xml version="1.0" encoding="utf-8"?> 
<GridLayout 
xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:useDefaultMargins-"true" 
android:columnCount-"4" > 


<TextView 
android: layout_columnSpan="4" 
android: layout ty="center_horizontal" 
android:text=" 于 GroidLayout 的 示例 " 
android:textSize="20dip" /> 
<TextView 
android:text=" 用 户 名 : " 
android:layout gravity-"right" /> 
«EditText 7 
android:ems="8" 
android: layout_columnSpan="2"/> 
<TextView 
android: text=" 
android: layout umn-"0" 
android:layout gravity-"right"/» 
«EditText Е 
android:ems="8" 
android: layout_columnSpan="2" /> 
<Button 
android: text=" ГА" 
android: layout_column="1" 
android: layout_gravity="fill_horizontal"/> 
<Button T Е 
android:text=" 下 一 步 " 
android: layout_column="2" 
android: layout_gravity="fill_horizontal"/> 
</GridLayout> E x 


在 上 述 代码 中 ，useDefaultMargins 表 示 网 格 布 
可 以 使 属性 在 这 里 定义 横向 的 行 数 。layout_columnSpan 


rowCount, 


界面 控件 ， 虽 然 定义 了 纵向 所 占据 的 块 的 数量 ， 但 却 没有 定义 元 素 起 始 位 置 所 在 的 块 ， 原 


因 是 网 格 布 


局 中 第 1 个 元 素 默认 在 第 0 行 第 0 列 。 定 义 了 第 2 个 界 


Н 


局 中 的 所 有 元 素 都 遵循 默认 的 边缘 规则 ， 所 有 元 素 之 间 都 会 留 有 一 定 的 边界 空间 。columnCount 表 示 纵 向 分 为 4 列 ， 从 第 0 列 到 第 3 列 ， 程 序 开发 人 员 也 
属性 表示 TextView 控 件 所 占据 的 列 的 数量 。layout_gravity=center_horizontal 表 示 文 字 内 容 在 所 占据 的 块 中 


居中 显示 。 定 义 了 第 1 个 
控件 ， 仍 然 没 有 定义 元 素 起 始 位 置 所 在 的 块 。 根 据 


网 格 布局 界面 元 素 的 


Е; 如 果 当 前 元 素 在 纵向 上 占据 多 个 块 ， 而 前 一 个 元 素 右 侧 没有 足够 数量 的 块 ， 则 当前 元 素 的 起 始 位 置 也 会 放置 在 下 一 行 的 第 一 个 块 上 。 


2.6 菜单 


菜单 是 应 用 程序 中 非常 
(Option Menu) 、 子 菜单 


要 的 组 成 部 分 ， 在 不 占用 界面 空间 的 前 提 下 ， 为 应 
(Submenu) 、 快 捷 菜单 (Context Menu) , 


Т) Android 程 序 的 菜单 可 以 在 代码 中 动态 生成 ， 使 用 XML 文件 制作 菜单 资源 ， 使 有 


程序 提供 统一 的 功能 和 设置 界面 ， 为 程序 开发 人 员 提供 易于 使 


XML 描述 菜单 可 以 将 菜单 的 内 容 与 代码 分 离 ， 有 利 


排 布 规则 ， 如 果 没 有 明确 说 明 元 素 所 在 的 块 ， 那 么 当前 元 素 会 放置 在 前 一 个 元 素 的 同一 行 右 侧 的 块 上 ;如 果 前 一 个 元 素 已 经 是 这 一 行 的 末尾 块 ， 则 当前 元 素 放置 在 下 一 行 的 第 一 个 块 


的 编程 接口 


。Android 系 统 支持 三 种 菜单 : 选项 菜单 


分 析 和 调整 菜单 结构 。 


Bl MenuResource 


Hello World, MenuResourceActivity! 


2) Java 代 码 生成 的 菜单 ， 如 图 


2-96 所 示 。 具 体 代码 如 下 : 


网 
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生成 的 菜单 


final static int 
final static 
final static 
final static 
final static 


QOverride 
public boolean onCreateOptionsMenu (Menu menu) { 


menu.add(0,MENU 00,0, "打印 ") . 
menu.add(0,MENU 01,1, "新 建 ") .setIcon 
menu.add(0,MENU 02,2, "邮件 ") .setIcon 
menu.add(0,MENU 03,3, "设置 ") .setIcon 
menu.add(0,MENU 04,4, "订阅 ") .setIcon 


return true;15 


MENU 00 = Menu.FIRST; 


) 


int MENU_01 = Menu.FIRST+1; 
int MENU 02 = Menu.FIRST+2; 
int MENU 03 = Menu.FIRST+3; 
int MENU 04 = Menu.FIRST+4; 


setIcon (R.drawable.pic0) ; 
R.drawable.picl); 
R.drawable.pic2); 
R.drawable.pic3); 
R.drawable.pic4); 


3) XML 荣 单 的 具体 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«menu xmlns:android-"http:// schemas.android.com/apk/res/android"> 


«item 


android: 


id="@+id/main_menu_0" 


android: icon="@drawable/pic0" 
android:title="47"p" /> 


<item 


android:id="@+id/main_menu_1" 


android: icon="@drawable/pici" 
android: title="#st" /> 


<item 


android: id="@+id/main_menu_2" 


android: icon="@drawable/pic2" 
android: ёіб1е=" иф" /> 


<item 


android: id="@+id/main_menu_3" 


android: icon="@drawable/pic3" 
android:title="#" /> 


<item 


android: id="@+id/main_menu_4" 


android: icon="@drawable/pic4" 
android: title="i7igj" /> 


</menu> 


上 述 代码 生成 具有 5 个 子 项 的 菜单 ，menu 是 菜 生 
单 资源 选择 的 菜单 模式 不 同 ， 菜 单项 图 标 可 能 会 不 显示 。MenuResource 示 例 使 用 


2.6.2 ”选项 菜单 


1. 图 标 菜单 


a 的 容器 ， 菜 和 


的 Android 系 统 菜 单 通过 “菜单 键 ” 


(Menu key) 打开 。 选 项 菜单 分 为 


图 标 菜单 是 能 够 同时 显示 文字 和 图 标的 菜单 ， 最 多 支持 6 个 子 项 。 图 


的 是 选项 菜单 ， 


Ий] 


资源 必须 以 menu 作 为 根 元 素 。item 是 菜单 项 ， 其 


因此 菜单 项 的 


标 没有 显示 ， 而 仅 显 示 了 菜单 项 的 标题 。 


标 菜单 (Icon Menu) 和 扩展 菜单 (Expanded Menu) 。 


标 菜单 不 支持 单 选 框 和 复 选 框 ， 如 图 


2-97 所 示 。 


属性 值 id、icon 和 title 分 别 是 菜单 项 的 ID 值 、 图 标 和 标题 。 定 义 了 菜单 项 的 图 


标 ， 但 菜 


2 扩展 菜单 


扩展 菜单 是 在 


Ий] 
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标 莱 单子 项 多 于 6 个 时 才 出 现 ， 通 过 点 击 图 标 菜单 最 后 的 子 项 “More” 才 能 打开 。 扩 展 菜 单 是 垂直 的 列表 型 菜单 ， 不 能 显示 | 


Ий] 


标 ， 支 持 单 选 框 和 复 选 框 ， 如 


Ий] 


2-98 所 示 。 


图 2-98 扩展 菜单 


1) 重 载 onCreateOptionMenu() 方 法 


来 初始 化 菜单 子 项 的 相关 内 容 。 


选项 菜单 。 初 次 使 用 选项 菜单 时 ， 会 调用 onCreateOptionMenu() 方 法 ,上 


看 载 Activity 的 onCreateOptionMenu() 方 法 ， 才 能 够 在 Android 应 用 程序 中 使 


8 


onCreateOptionsMenu() 方 法 代码 如 下 : 


public boolean onCreateOptionsMenu (Menu menu) { 
menu.add (Menu.NONE，1，8，" 删 除 ") ~setIcon(android.R.drawable.ic menu delete); 


menu.add(Menu.NONE, 2, 2, "保存 ") .setIcon (android.R.drawable.ic menu edit); 


menu.add (Menu. 
menu. add (Menu 


menu.add 
menu.add 


Menu. 
Menu. 
menu.add (Menu. 
menu.add (Menu. 
menu.add (Menu. 


// i truedt 3 + BAPE 65, 菜单 


return true; 


NONE, 
„ЛОМЕ, 
МОМЕ, 
МОМЕ, 
МОМЕ, 
МОМЕ, 
МОМЕ, 


.SetIcon (android.R.drawable.ic_menu_help) ; 
.setIcon( android.R.drawable.ic | menu add); 


.setIcon( android.R.drawable.ic menu info | details); 


.SetIcon (android.R.drawable.ic menu | send) ; 

.SetIcon (android.R.drawable. ici menu | share); 
.SetIcon (android.R.drawable.ic menu search); 
.setIcon (android.R.drawable.ic menu call); 


否则 不 能 够 显示 菜单 


2) 选项 菜单 的 add() 方 法 。 


Menu 对 象 作为 一 个 参数 被 传递 到 方法 内 部 ， 因 此 在 onCreateOptionsMenu( 方 法 中 ， 


户 可 以 使 


Menu 对 象 的 add() 方 法 添加 菜单 子 项 。add() 方 法 的 语法 为 : 


MenuItem android.view.Menu.add(int groupId, int itemId, int order, CharSequence title) 


“ 参数 groupId 是 组 ID， 如 果 不 需 


要 可 以 设置 为 Menu.NONE。 


- 参数 itemId 是 menu 当 中 每 一 项 的 id， 这 个 id 应 该 是 唯一 的 。 


“ 参数 order 是 排序 的 信息 ， 根 据 这 个 字段 的 大 小 ， 


“ 参数 title 是 菜单 子 项 所 显示 的 标题 。 


3) 


onOptionsltemSelected (Menultem item) 方法 ， 当 用 户 单 击 指定 菜单 项 时 ， 程 序 可 以 为 菜单 项 的 单 击 寻 


menu 对 其 中 的 项 进行 排序 显示 ，order 小 的 显示 在 前 面 ， 大 的 在 后 


onOptionsltemSelected (Menultem item) 方法 中 进行 判断 。 由 于 程序 需要 在 该 方法 中 准确 判断 单 击 了 哪个 菜单 项 ， 因 此 添加 菜单 时 应 为 每 个 菜单 项 


Menultem.getltemld() 方 法 可 以 获取 被 选择 菜单 子 项 的 D，onOptionsltemSelected() 的 返回 值 表示 是 否 对 菜单 的 选择 事件 进行 处 理 ， 如 果 已 经 处 理 过 


指定 ID。 


返回 true， 否 则 返 


件 提供 响应 。 如 果 需 要 针对 不 同 菜单 提供 响应 ， 就 要 在 


false。 具 体 代码 如 下 : 


回 


public boolean onOptionsItemSelected (MenuItem item) { 


switch (item.getItemId() ) 
1: 


case 
case 
case 
case 
case 
case 
case 
case 
case 


Toast 


2:Toast 
3:Toast 
4:Toast 
53 
6 
7 
8 


Toast 


:Toast 
:Toast 
:Toast 
Ge 


Toast 


default: break; 


} 


return false; 


{ 
.makeText (this, 
.makeText (this, 
-makeText (this, 
.makeText (this, 
-makeText (this, " 
-makeText (this, 
.makeText (this, 
.makeText (this, 
.makeText (this, 


"删除 "， Toast.LENGTH LONG) .show();break; 
"Д", Toast.LENGTH LONG) .show() ;break; 
" "9Р8 34", Toast. LENGTH_LONG) . show () ;break; 
Toast. LENGTH LONG) . show () ; break; 
Toast.LENGTH LONG) . show () ; break; 
Toast. LENGTH_LONG) .Show () ;break; 
, Toast.LENGTH LONG) . show () ; break; 
Toast . LENGTH LONG) . Show () ; break; 

, Toast.LENGTH LONG).show(); break; 


4) 


onPrepareOptionsMenu(75;iE, 8 


能 够 动态 地 添加 、 删 除 菜单 子 项 ， 或 修改 菜单 的 标题 、 


方法 相同 ， 返 回 true 则 显示 ， 返 


回 


false 则 不 显示 。 具 体 代码 如 下 : 


Ий] 


标 和 可 见 性 等 内 容 。onPrepareOptionsMenu() 方 法 的 返 


回 


值 的 含义 与 onCreate-OptionsMenu() 


public boolean onPrepareOptionsMenu (Menu menu) { 


Toast.makeText (this，" 选 项 菜单 显示 之 前 onPrepareOptionsMenu 方 法 会 被 调用 "， 
return true; 


} 


263 FRÆ 


子 菜单 是 能 够 显示 更 加 详细 信息 的 荣 和 


子 项 ， 菜 单子 项 采 


浮动 窗 体 的 显示 形式 ， 能 够 更 好 地 适应 小 


Toast .LENGTH LONG) . show () ; 


幕 的 显示 方式 ， 如 图 2-99 所 示 。 


创建 子 菜单 的 步骤 如 下 : 


覆盖 Activity 的 onCreateOptionsMenu( 方 法 , 调 


件 。 


Android 系 统 的 子 菜单 使 
addSubMenu() 方 法 实现 。 


1) Menu 的 addsubMenu() 方 法 与 add() 方 法 一 样 ， 它 有 以 下 四 个 导 


非常 灵活 ， 可 以 在 选项 菜单 或 快捷 菜单 中 使 


Menu 的 addSubMenu0) 方 法 来 添加 子 菜单 ; 调用 SubMenu 的 add() 方 法 添加 子 菜单 ; 覆盖 onOptionsltemselected() 方 法 ， 响 应 子 菜 生 


П 6:50 AM 


299 ФФ 


pE: 


AES 


子 菜单 ， 有 利于 将 相同 或 相似 的 菜单 子 项 组 织 在 一 起 ， 便 于 显示 和 分 类 。 子 菜单 不 支持 谋 套 ， 子 菜单 的 添加 使 


ERTA: 


public abstract SubMenu addSubMenu (int groupId, int itemId, int order, CharSequence title) 
public abstract SubMenu addSubMenu (int groupId, int itemId, int order, int titleRes) 
public abstract SubMenu addSubMenu (CharSequence title) 

public abstract SubMenu addSubMenu (int titleRes) 


2) 子 菜单 的 实现 如 图 2-100 至 图 2-102 所 示 。 


private TextView tx; 
private final static int GROUP1=17 
private final static int GROUP2=2; 
private final static int NEW_COLOR1=Menu. FIRST; 
private final static int NEW COLOR2=NEW COLOR1+1; 
private final static int NEW_COLOR3=NEW_COLOR2+1; 
private final static int NEW HOBBYI-NEW COLOR3+17 
private final static int NEW HOBBY2-NEW НОВВҮ1+1; 
private final static int NEW HOBBY3-NEW НОВВҮ2+1; 
private Menultem bgl,bg2,bg3; 
private MenuItem hobby[]=new MenuItem[3]; 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
tx-(TextView) findViewById(R.id.tx); 


public boolean onCreateOptionsMenu (Menu menu) { 
SubMenu submenul-menu.addSubMenu (" # 3& Jf E"); 
submenul.setIcon (R.drawable.q4) ; 
submenul.setHeaderIcon (R.drawable.q4); 
bgl=submenul.add(GROUP1, NEW COLORI, 1, "Ж ё"); 
bg2=submenul.add(GROUP1, NEW COLOR2, 2, "ЖЖЖ ё"); 
bg3=submenul.add(GROUP1, NEW_COLOR3, 3, "i| 55e"); 
bgl.setChecked (true); 

// 设置 GROUP1 组 是 可 选 的 、 互 斥 的 
submenul.setGroupCheckable(GROUP1, true, true); 
SubMenu submenu2-menu.addSubMenu ("我 的 爱好 ") ; 
hobby [0]=submenu2 .add (GROUP2, NEW_HOBBY1, 1, 
hobby [1 ubmenu2.add(GROUP2, NEW HOBBY2, 2, 
hobby [2]=submenu2 . add (GROUP2, NEW НОВВҮЗ, 3, 4 
hobby [0] . setCheckable (true) ; 
hobby[1].setCheckable (true) ; 

hobby[2] .setCheckable (true) ; // 设置 为 可 多 选 
return super.onCreateOptionsMenu (menu); 


} 
public boolean onOptionsItemSelected (MenuItem item) { 
switch (item.getItemId() ) { 
case NEW COLORI: 
case NEW COLOR2: 
case NEW COLOR3:item.setChecked (true); selectColor(); break; 
case NEW HOBBYI: 
case NEW HOBBY2: 
case NEW HOBBY3: 
item.setChecked(!item.isChecked()); selectColor(); break; 
} 
return super.onOptionsItemSelected (item) ; 
} 
private void selectColor() { 
if (bgl.isChecked()) { 
tx.setBackgroundResource (R.color.cl) ; 
} else if (bg2.isChecked()) { 
tx.setBackgroundResource (R.color.c2); 
} else if (bg3.isChecked()) { 
tx.setBackgroundResource (R.color.c3); 
) else ( 


for (Menultem mi : hobby) ( 
if (mi.isChecked()) ( 
tx.setText (tx.getText().toString() + mi.getTitle()); 
} 


H3 +11:58 
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d L| 


深 天 蓝 色 


间 春 绿色 


图 2-102 


我 的 爱好 


Android 中 的 快捷 菜单 就 是 ContextMenu。ContextMenu 的 效果 就 像 是 PC 上 的 鼠标 右键 ， 当 为 一 个 视图 注册 快捷 菜单 之 后 ， 长 按 (2 秒 左右 ) 这 个 视图 


何 视图 


都 可 以 注册 快捷 菜单 ， 不 过 ， 最 常见 的 是 


于 列表 视图 


ListView 的 item。 


对 象 就 会 弹出 一 个 浮动 菜单 ， 即 快捷 菜单 。 任 


快捷 菜单 不 同 于 选项 菜单 ， 选 项 菜单 服务 于 Activity， 而 快捷 菜单 则 是 注册 到 某 个 View 对 象 上 的 。 如 果 一 个 View 对 象 注 册 了 快捷 菜单 ， 用 户 可 以 通过 长 按 该 View 对 象 以 呼出 快捷 菜单 。 快 捷 菜 单 不 支持 
快捷 键 ， 其 菜单 选项 也 不 能 附带 图 标 ， 但 是 可 以 为 快捷 菜单 的 标题 指定 图 标 。 


1. 快 捷 荣 单 使 用 方法 


快捷 菜单 同样 采用 了 动 窗 体 的 显示 方式 ， 与 子 菜单 的 实现 方式 相同 ， 但 两 种 菜单 的 启动 方式 却 截然 不 同 。 


启动 方式 : 快捷 菜单 类 似 于 普通 桌面 程序 中 的 “右键 菜单 ”， 当 用 户 长 按 界面 元 素 超 过 2 秒 后 ， 将 启动 注册 到 该 界面 元 素 的 快捷 菜 


使 用 方法 : 与 使 用 选项 菜单 的 方法 非常 相似 ， 需 要 重 载 onCreateContextMenu() 方 法 和 onContextltemSelected() 方 法 。onCreateContextMenu() 方 法 主要 用 来 添加 快捷 菜单 所 显示 的 标题 、 图 标 和 
菜单 子 项 等 内 容 。 选 项 菜单 中 的 onCreateOptionsMenu() 方 法 仅 在 选项 菜单 第 一 次 启动 时 被 调用 一 次 ， 快 捷 菜单 的 onCreateContextMenu() 方 法 每 次 启动 时 都 会 被 调用 一 次 。 


2. 开 发 快捷 菜单 的 步骤 


覆盖 Activity 的 onCreateContenxtMenu() 方 法 ， 调 用 Menu 的 add 方 法 添加 菜单 项 (Menultem) 。 覆 盖 Activity 的 onContextltemSelected() 方 法 ， 响 应 快捷 菜单 菜单 项 的 单 击 事件 。 调 F 
registerForContextMenu() 方 法 为 视图 注册 快捷 菜单 。 


1) 通过 registerForContextMenu() 方 法 将 快捷 菜单 注册 到 界面 控件 上 。 这 样 ， 用 户 在 长 按 该 界面 控件 时 ， 便 会 启动 快捷 菜单 ， 具 体 代 码 如 下 : 


public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
txt=(TextView) findViewById (R.id.textview); 
registerForContextMenu (txt); 


) 


2) ContextMenu 类 支持 add() 方 法 和 addSubMenu() 方 法 ， 可 以 在 快捷 菜单 中 添加 菜单 子 项 和 子 菜单 。onCreateContextMenu() 方 法 中 的 参数 如 下 : 
- 参数 menu 是 需要 显示 的 快捷 菜单 ; 
- 参数 vY 是 用 户 选择 的 界面 元 素 ; 


+ 参数 menuInfo 是 所 选择 界面 元 素 的 额外 信息 。 


public void onCreateContextMenu (ContextMenu menu, View v,ContextMenuInfo menuInfo) { 
menu.add(0,MENU1, 0, "java"); 
menu.add(0,MENU2, 0, "3G"); 
menu.add(0,MENU3, 0, "php"); 
// 将 三 个 菜单 项 设 为 单 选 菜单 项 
menu.setGroupCheckable(0, true, true); 
// 设置 快捷 菜单 的 图 标 、 标 题 
menu.setHeaderIcon (R.drawable.h3); 
menu.setHeaderTitle (" 选 择 专业 ") 7 


3) 重 载 onContextltemSelected() 方 法 。 


菜单 选择 事件 的 处 理 需 要 重 载 onContextltemSelected() 方 法 ， 该 方法 在 用 户 选 择 快 捷 菜 单 中 的 荣 单子 项 后 被 调用 ， 与 onOptionsltemselected() 方 法 的 使 用 方法 基本 相同 。 


public boolean onContextItemSelected (MenuItem item) { 
switch (item. getItemId() ) { 
case MENU1:item.setCheckable (true) ; 
txt.setText ("你 选择 了 java") ; break; 
case MENU2:item.setCheckable (true); 
txt.setText ("你 选择 了 3G") ;break; 
case MENU3:item.setCheckable (true); 
txt.setText ("你 选择 了 php") ;break; } 
return true; 


4) 布局 文件 。 


下 方 代码 是 /src/layout/main.xml 文 件 的 部 分 内 容 ， 将 android:layout_width 设 置 为 fl parent， 这 样 TextView 将 填 满 父 节点 的 所 有 剩余 屏幕 空间 ， 用 户 点 击 屏 幕 TextView 下 方 任何 位 置 都 可 以 启动 快 
捷 菜 单 。 如 果 将 android:layout_width 设 置 为 wrap_content， 则 用 户 必须 准确 点 击 TextView 才 能 启动 快捷 菜单 。 


<TextView 
android: layout_width="fill parent" 
android: layout height-"wrap content" 
android:text=" 测 试 快捷 菜单 "” T 
android: id="@+id/textview" 


/> 


将 android:layout_ width 设置 为 fl_parent， 这 样 TextView 将 填充 满 父 节点 的 所 有 剩余 屏幕 空间 ， 用 户 点 击 屏幕 TextView 下 方 任何 位 置 都 可 以 启动 快捷 菜单 。 如 果 将 android:layout_width 设 置 为 
wrap_content， 则 用 户 必 须 准确 点 击 TextView 才 能 启动 快捷 菜单 ， 如 图 2-103 所 示 。 
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82-103 ”启动 快捷 菜单 


2.7.1 Androi 


不 管 是 桌面 应 用 还 是 手机 应 用 程序 ， 面 对 最 多 的 就 是 用 户 ， 经 常 需要 处 理 的 就 是 用 户 动作 。 应 用 程序 需要 为 用 户 的 动作 提供 响应 ， 这 种 为 用 户 动 作 提供 响应 的 机 制 就 是 事件 处 理 。Android 提 供 了 强大 
的 事件 处 理 机 制 ， 包 括 两 套 事件 处 理 机 制 : 基于 监听 的 事件 处 理 和 基于 回调 的 事件 处 理 。 


Т) 基于 监听 的 事件 处 理 的 对 象 。 


基于 监听 的 事件 处 理 是 一 种 “面向 对 象 ”的 事件 处 理 ， 主 要 涉及 如 下 三 个 对 象 。 


“ EventSource (事件 源 ) : 事件 发 生 的 场所 ， 通 常 就 是 各 个 组 件 ， 例 如 窗口 、 按 钮 、 菜 单 等 。 
“ Event (事件 ) : 事件 封装 了 界面 组 件 上 发 生 的 特定 事情 ， 通 常 是 一 次 用 户 操作 ， 如 果 程 序 需要 获得 界面 组 件 上 所 发 生 事件 的 相关 信息 ， 一 般 通 过 Event 对 象 来 获取 。 


- EventListener (事件 监听 器 ) : 负责 监听 事件 源 所 发 生 的 事件 ， 并 对 各 种 事件 做 出 响应 。 


Android 的 事件 处 理 机 制 是 一 种 委派 式 事件 处 理 方式 : 普通 组 件 (事件 源 ) 将 整个 事件 处 理 委托 给 特定 的 对 象 (事件 监听 器 ) ; 当 该 事件 源 发 生 指定 的 事件 时 ， 就 通知 委托 的 事件 监听 器 ， 由 事件 监听 
器 处 理 这 个 事件 。 每 个 组 件 均 可 以 针对 特定 的 事件 指定 一 个 事件 监听 器 ， 每 个 事件 监听 器 也 可 监听 一 个 或 多 个 事件 源 。 同 时 也 可 以 让 一 类 事件 使 用 同一 个 事件 监听 器 来 处 理 。 事 件 处 理 的 流程 如 图 2-104 所 


示 。 


外 部 动作 


. 解 发 事 dedi 事件 被 作为 
参数 传人 事件 处 理 需 


5. 调用 事件 
TT 做 出 啊 应 


1. 将 事件 监听 融 注 册 
到 事件 源 


图 2-104 ”事件 处 理 示 意图 


2) 基于 监听 的 事件 处 理 模 型 的 编程 步 又。 


“ 获取 普通 界面 组 件 ( 事 件 源 ) ， 也 就 是 被 监听 的 对 象 。 
' 实现 事件 监听 器 类 ， 该 监听 器 类 是 一 个 特殊 的 Java 类 ， 必 须 实现 一 个 XxxListener 接 口 。 
- 调用 事件 源 的 setXxxListenet 方 法 将 事件 监听 器 对 象 注册 给 普通 组 件 。 


; 当 事 件 源 上 发 生 指定 事件 时 ，Android 会 触发 事件 监听 器 ， 由 事件 监听 器 调用 相应 的 方法 (事件 处 理 器 ) 来 处 理事 件 。 


3) 匿名 内 部 类 作为 事件 监听 器 的 main.xml 文 件 代码 如 下 ， 运 行 结果 如 图 2-105 所 示 。 


2-105 


匿名 内 部 类 作为 事件 监听 器 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http:// schemas.android.com/apk/res/android" 


android: orientation="vertical" 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
android:gravity-"center horizontal"? 
<EditText 
android: id="@+id/show" 
android: layout_width="fill_ parent" 
android: layout_height="wrap_content" 
android:editable-"false" ` 
/> 
<Button 
android: id="@+id/bn" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:editable-"false" ~ 


/> 
</LinearLayout> 
public class AnonymousListenerTest extends Activity 
{ 
EdiText show; 
Button bn; 
Goverride 
public void onCreate (Bundle savedInstanceState) 


super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
show= (EditText) findViewById (R.id.show); 
bn= (Button) findViewById (R.id.bn); 
// 直接 使 用 ACTIVITY 作 为 事件 监听 器 
bn.setOnClickListener (new OnClickListener () 
{ 
// 实现 事件 处 理 方法 
public void onClick(View v) 


// TODO Auto-generated method stub 
show.setText ("bn 按钮 被 单 击 了 "); 


Android 还 有 一 种 更 加 简单 的 绑 定 事件 监听 器 的 方式 ， 直 接 在 界面 布 
值 就 是 一 个 形 如 xxx (View source) 的 方法 名 。 


局 文件 中 为 指定 标签 事件 处 理 方法 。 对 很 多 Android 界 面 组 件 而 


=, 


它们 都 支持 如 onClick、onLongClick 等 


属性 ， 这 种 


属性 的 


属性 


[IR] 


4) 直接 绑 定 到 标签 main.xml 文 件 的 代码 如 下 ， 运 行 结果 如 | 


2-106 所 示 。 


bn 按 租 被 里 击 了 


图 2-106 直接 绑 定 到 标签 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:orientation-"vertical" 

:layout width-"fill parent" 

ayout height-"fill parent" 

:gravity-"center horizontal" 


> 

<EditText 
android: id="@+id/show" 
android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android:editable-"false" ^ 
android:cursorVisible-"false" 
/> 

<!-- 在 标签 中 为 按钮 绑 定 事件 处 理 方法 --> 

<Button 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/clk" 7 
android: onClick="clickHandler" 

/> 

</LinearLayout> 


package com.whq; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.EditText; 
public class BindingTag extends Activity{ 
Goverride 
public void onCreate (Bundle savedInstanceState) 
{ 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


} 
// 定义 一 个 事件 处 理 方法 
// 其 中 source 参 数 代 表 事 件 源 


public void clickHandler(View source) 


EditText show=(EditText) findViewById (R.id.show); 


show. setText ("bn 按钮 被 单 击 了 "); 


} 
l 


273 ”基于 回调 的 事件 处 理 


Android 基 于 | 


回调 的 事件 处 理 ， 主 要 是 重 写 Android 组 件 特定 的 回调 方法 ,或 者 重 写 Activity 的 方法 。 对 基于 回调 的 事件 处 理 模型 来 说 ， 事 件 源 和 事件 监听 器 是 统一 的 ， 或 者 说 是 事件 监听 器 完全 消失 


了 。 当 用 户 在 GUI 组 件 上 激发 某 个 事件 时 ， 组 件 自己 特定 的 方法 将 会 负责 处 理 该 事件 。 为 了 实现 回调 机 制 的 事件 处 理 ，Android 为 所 有 GUI 组 件 都 提供 了 一 些 事件 处 理 的 回调 方法 ， 以 View 为 例 ， 该 类 包含 


如 下 方法 : 


` bool 


` bool 


lean onKeyDown (int keyCode, 
ean onKeyLongPress (int keyCode, Key! 


lean onKeyShortcut (int keyCode , 


ean onKeyUp (int keyCode, 


ean onTouchEvent (MotionEvent event) : 


ean onTrackballEvent (MotionEvent event) : 


KeyEve 


nt event) : 当 用 户 在 该 组 件 上 按 下 某 


个 按键 时 触发 该 方法 。 


Event event) : 当 用 户 在 该 组 件 上 长 按 某 个 按键 时 触发 该 方法 。 


KeyEvent event) : 当 一 个 键盘 快捷 键 事件 


KeyEvent event) : 


当 用 户 在 该 组 件 上 和 触发 触摸 屏 事件 


发 生 时 触发 该 方法 。 


当 用 户 在 该 组 件 上 松 开 某 个 按键 时 触发 该 方法 。 


时 触发 该 方法 。 


当 用 户 在 该 组 件 上 触发 轨迹 球 屏 事件 时 触发 该 方法 。 


Android 平 台中 ， 每 个 View 都 有 自己 的 处 理事 件 的 回调 方法 ， 开 发 人 员 可 以 通过 
的 回调 方法 。 


1) 自 定义 的 View 如 图 


2-107 所 示 。 


写 View 中 的 这 些 回调 方法 来 实现 需要 的 响应 事件 。 当 某 个 事件 没有 被 任何 一 个 View 处 理 时 ， 便 会 调用 Activity 中 相应 
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图 2-107 自 定义 的 View 


CallbackHandlerJava 代 码 如 下 ， 运 行 结果 如 图 2-108 所 示 。 


package com.whq; 
import android.app.Activity; 
import android.os.Bundle; 
public class CallbackHandler extends Activity 
{ 
GOverride 
public void onCreate (Bundle savedIntanceState) 
{ 
super .onCreate (savedIntanceState) ; 
setContentView (R.layout.main) ; 
} 
} 
«xml version-"1.0" encoding-"utf-8"» 
<LinearLayout xmlns: android="http:// schemas. 
android: orientation="vertical" 
android: layout_width="fill parent" 
android:layout height-"fill parent" 


> 
<!-- 使 用 自 定 义 View 时 应 使 用 权限 定 类 名 一 -> 
<com.whq.MyButton 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
android:text-" 3b 4 4" 
/> 
</ LinearLayout> 


2) 基于 回调 的 事件 传播 。 


几乎 所 有 基于 回调 的 事件 处 理 方法 都 有 一 个 boolean 类 型 的 返回 值 ， 该 方法 用 于 标识 该 处 理 方法 是 否 能 完全 处 理 该 事件 : 如 果 处 理事 件 的 回调 方法 返回 true， 表 明 该 处 理 方法 已 完全 处 理 该 事件 ， 该 事 
件 不 会 传播 出 去 。 如 果 处 理事 件 的 回调 方法 返回 false， 表 明 该 处 理 方法 并 未 完全 处 理 该 事件 ， 该 事件 会 传播 出 去 。 


对 基于 回调 的 事件 传播 而 言 ， 某 组 件 上 所 发 生 的 事情 不 仅 激发 该 组 件 上 的 回调 方法 ， 也 会 触发 该 组 件 所 在 Activity 的 回调 方法 (只 要 事件 能 传播 到 该 Activity) 。 


82-108 B EUER 


92-109 ”基于 回调 的 事件 传播 


基于 回调 的 事件 传播 main.xml 文 件 代码 如 下 ， 运 行 结果 如 


[IR] 


2-109 所 示 。 


package com.whq; 
import android.content.Context; 
public class MyButton extends Button{ // 构造 方法 
public MyButton (Context context, AttributeSet set) { 
super (context, set); 
} 
GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 


super .onKeyDown (keyCode, event) ; 
// 返回 false， 表 明 并 未 完全 处 理 该 事件 ， 该 事件 依然 向 外 扩散 
return false; 
} 
} 
public class Propagation extends Activity{ 
GOverride 
public void onCreate (Bundle savedInstanceState)( 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
Button bn = (Button) findViewById (R.id.bn); 
// 为 bn 绑 定 事件 监听 器 
bn.setOnKeyListener (new OnKeyListener) { 
public boolean onKey (View source, int keyCode, KeyEvent event0) { 
// 只 处 理 按 下 键 的 事件 
if (event.getAction ()==KeyEvent .ACTION_DOWN) { 
Log.v("-Listener-", "the onKeyDown in Listener"); 


} 
// 返回 false， 表 明 该 事件 会 向 外 传播 
return false; 
l 
p; 


l 
// 重 写 onKeyDown 方法 ， 该 方法 可 监听 它 所 包含 的 所 有 组 件 的 按键 被 按 下 事件 
GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
super.onKeyDown (keyCode, event) ; 
Log.v("- Activity-","the onKeyDown in Activity"); 
// 返回 false， 表 明 并 未 完全 处 理 该 事件 ， 该 事件 依然 向 外 传播 
return false; 
} 
} 
<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android="http:// schems. 
android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 
«1--4k H] Ë Ж 3 View pL J £ R RRL) 
<com.whq.MyButton 
android: id="@+id/bn" 
android: layout_width="fill parent" 
android: layout height-"wrap content" 
android:tex=""24 &"/> жй 
</LinearLayout> 


对 比 Android 提 供 的 两 种 事件 处 理 模型 ， 不 难 发 现 基于 监听 的 事件 处 理 模型 具有 更 大 的 优势 : 基于 监听 的 事件 模型 分 工 更 明确 ， 事 件 源 、 事 件 监听 器 由 两 个 类 分 开 实现 ， 因 此 具有 更 好 的 可 维护 性 。 
Android 的 事件 处 理 机 制 保证 会 优先 触发 基于 监听 的 事件 监听 器 。 


274 响应 的 系统 设置 的 事件 


在 开发 Android 应 用 时 ， 有 时 候 可 能 需要 让 应 用 程序 随 系统 设置 而 进行 调整 ， 比 如 判断 屏幕 方向 、 判 断 系 统 方向 的 方向 导航 设备 等 。 除 此 之 外 ， 有 时 还 需要 让 应 用 程序 监听 系统 设置 的 更 改 ， 对 系统 设 
置 的 更 改 做 出 响应 。 


1) Configuration 类 的 简介 。 


Configuration 类 专门 用 于 描述 手机 设备 上 的 配置 信息 ， 该 类 包含 了 很 多 种 信息 ， 例 如 系统 字体 大 小 、orientation 输 入 设备 类 型 等 。 


程序 可 调用 Activity 的 如 下 方法 来 获取 系统 的 Configuration 对 象 。 


Configuration cfg=getResources ().getConfiguration(); 


Configuration 对 象 提供 了 以 下 方法 来 获取 系统 的 配置 信息 。 

ublic float fontScale: 获取 当前 用 户 设 置 的 字体 的 缩放 因子 。 

ublic int keyboard: 获取 当前 设备 的 键盘 类 型 。 

ublic int keyboardhidden: 该 属性 返回 一 个 boolean 值 用 于 标识 当前 的 键盘 是 否 可 用 。 


ublic Localde locale: 用 户 选择 的 location 信 息 。 


= 


ublic int тсс: 获取 移动 信号 的 国家 码 。 


ublic int тпс: 获取 移动 信号 的 网 络 码 。 


ublic int orientation: 获取 系统 屏幕 的 方位 。 


ublic int touchscreen: 获取 系统 触摸 屏 的 触摸 方式 。 


2) 获取 系统 设备 状态 如 图 2-110 和 图 2-111 所 示 。 


i 5554:Fofo 


a Wi] €3 15:03 


获取 系统 设备 配置 信息 
显示 屏幕 方向 


显示 手机 方向 控制 设备 
显示 触摸 屏 状态 


显示 移动 网 络 代号 


E 5554:Fofo 


获取 系统 设备 配置 信息 


没有 方向 控制 


受 手 措 的 触摸 屏 


图 2-111 获取 系统 设备 状态 (2) 


package com.whq; 
import android.app.Activity; 
import android.app.content.res.Configuration; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.onClickListener; 
import android.widget .Button; 
import android.widget .EditText; 
public class configurationText extends Activity{ 
EditText ori; 
EditText navigation; 
EditText touch; 
EditText mnc; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R. layout .main) ; 
// 获取 应 用 界面 中 的 界面 组 件 
ori-(EditText) findViewById(R.id.ori); 
navigation=(EditText) findViewById(R.id.navigation) ; 
touch-(EditText) findViewById (R.id.touch); 
mnc-(EditText) findViewById (R.id.mnc); 
Button bn= (Button) findViewById (R.id.bn); 
bn.setOnClickListener (new OnClickListener () { 
// 为 按钮 绑 定 事件 监听 器 
public void onClick(View source) { 
// 获取 系统 的 Configuration 对 象 
Configuration cfg=getResources ().getConfiguration(); 
String screen-cfg.orientation--Configuration.ORIENTATION LANDSCAPE 
"横向 屏幕 ":" 坚 向 屏幕 "7 
String mncCode=cfg.mnct""; 
String naviName=cfg.orientation==Configuration.NAVIGATION NONAV "没有 方向 控制 " 
: cfg.orientation--Configuration.NAVIGATION WHEEL "滚轮 控制 方向 " 
"方向 键 控制 方向 ": "轨迹 球 控制 方向 "7 
navigation.setText (naviName) ; 
String touchName=cfg.touchscreen==Configuration. TOUCHSCREEN NOTOUCH "无 触摸 屏 " 
: cfg.touchscreen--Configuration.TOUCHSCREEN STYLUS "触摸 笔 式 触 摸 屏 " 
"接受 手指 的 触摸 屏 "7 
ori.setText (screen) ; 
mnc.setTex (mncCode) ; 
touch.setTex (touchName) ; 
} 


n; 


如 果 程 序 需要 监听 系统 设置 的 更 改 ， 则 可 以 考虑 重 写 Activity 的 onConfigurationChanged 人 方法， 
动态 地 更 改 系统 设置 ， 调 用 Activity 的 setRequestedOrientation(int) 方 法 来 修改 屏幕 的 方向 。 


3) 监听 系统 设置 的 更 改 代码 如 下 ， 运 行 结果 如 图 2-112 和 图 2-113 所 示 。 


该 方法 是 一 个 基于 回调 的 


件 处 理 方法 。 当 系统 设置 发 生 更 改 时 ， 该 方法 会 被 自动 触发 。 为 了 在 程序 中 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http:// schems. 
android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android:layout height-"fill parent"? 
«Button 
android: id="@+id/bn" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:tex=" 更 改 屏幕 方向 "/> 
</LinearLayout> 
public class ChangeCfg extends Activity 
{ 


QOverride 
public void onCreate (Bundle savedInstanceState) 
{ 
super .onCreate (savedInstanceState); 
setContentView (R.layout.main) ; 
Button bn = (Button) findViewById (R.id.bn); 
// 为 按钮 绑 定 事件 监听 器 
bn.setOnClickListener (new OnClickListener () 


public void onClick(View source) 
{ 
Configuration config = getResources () .getConfiguration () ; 
// 如 果 当 前 是 横 屏 
if (config.orientation 
== Configuration.ORIENTATION LANDSCAPE) 


// RAER 
ChangeCfg.this.setRequestedOrientataion ( 
ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) ; 


{ 


} 
n; 


l 
// 重 写 该 方法 ， 用 于 监听 系统 设置 的 更 改 ， 主 要 是 监听 屏幕 方向 的 更 改 
public void onConfigurationChanged (Configuration newConfig) 
{ 
super .onConfigurationChanged (newConfig) ; 
String screen = newConfig.orientation == 
Configuration.ORIENTATION LANDSCAPE "横向 屏幕 ": " 坚 向 屏幕 "7 
Toast.makeText (this，" 系 统 的 屏幕 方向 发 生 改 变 " 
+ "An 修改 后 的 屏幕 方向 为 : " + screen 
; Toast.LENGTH LONG) 
«show () 7 


更改 屏幕 方向 


系统 的 屏幕 方向 发 生 改 变 
收 改 后 的 屏幕 方向 为 ; 2 [5Ј/Я A 


< 


?mxl version="1.0" encoding-"utf- 
android-"http:// emas . android.com/apk/res/andro. 


android:minSdkVersion-"8"/» 
«application 
android: icon="@drawable/ic_ launcher" 
android: label="@string/app name" 
HLH Activity Ai 1s 7k 53 2/5] (orientationorientation) --> 
<activity 
android:name-".ChangeCfg" 
android:label ring.app name" 
s="orientation"> 
<intent-filter> 
«action android:name-"android.intent.action.MAIN"/» 


«category android:nam android.intent.category.LAUNCHER"/» 


intent-filte 


13 ”修改 屏幕 的 方向 


2.7.5 Handler 消 息 传递 机 制 


在 Android 平 台中 ， 新 启动 的 线程 是 无 法 访问 Activity 里 的 Widget 的 ， 当 然 也 不 能 


1) Handler 类 的 主要 作用 。 


运行 状态 外 送出 来 ， 这 就 需要 用 Handler 机 制 进 


Handler 类 的 3 


2) Handler 类 的 常用 方法 。 常 用 方法 如 下 : 


* void handleMessage (Message msg) : 子 类 对 象 通过 该 方法 接收 


要 作用 有 两 个 : 在 新 启动 的 线程 中 发 送 消息 ;在 主线 程 中 获取 、 处 理 消息 。 


信息 ， 该 方法 用 于 被 重 写 。 


: 监测 消息 队列 中 是 否 还 有 what 值 的 消息 。 


asMessages (int what, Object object) : 监测 消息 队列 中 是 否 包 含 对 象 是 object 且 属性 是 what 值 的 消息 。 


通过 handleMessage 方 法 接收 。 


* final boolean hasMessages (int what) 

* final boolean 

- Message obtainMessage(): 获取 消息 。 

* final boolean sendEmptyMessage (int what) : 发 送 一 个 只 含有 what 值 的 消息 。 
* final boolean sendMessage (Message msg) : 发 送 消息 到 Handler， 

> final boolean sendMessageDelayed (Message msg, long delayMillis) 


ИЙ] 


3) Handler 类 的 使 用 代码 如 下 ， 运 行 结 果 如 


2-114 所 示 。 


public class HandlerTest extends Activity 
{ 

// 定义 周期 性 显示 的 图 片 ID 

int[] imageIds new int[] 

{ 


R. drawable. 
R.drawable. 
R.drawable. 
R.drawable. 
R.drawable. 


java, 
ee, 
ajax, 
xml, 
classic 
1; 
int currentImageId = 0; 
public void onCreate (Bundle savedInstanceState) 
{ 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
final ImageView show (ImageView) 
findViewById (R.id.show) ; 
final Handler myHandler 


new Handler () 
public void handleMessage (Message msg) 


// 如 果 该 消息 是 本 程序 所 发 送 的 
if (msg.what == 0x1233) 
{ 


// 动态 地 修改 所 显示 的 图 片 


: 指定 多 少 毫秒 之 后 发 送 消息 。 


show. set ImageResource (imageIds [currentImageId++]) 7 


if (currentImageId >= 4) 
{ 
currentImageId = 0; 
] 
} 
l 


b 
// 定义 一 个 计时 器 ， 让 该 计时 器 周期 性 地 执行 指定 任务 
new Timer().schedule (new TimerTask () 


{ 


public void run() 
{ 


// 新 启动 的 线程 无 法 访问 该 Activity 里 的 组 件 
// 所 以 需要 通过 Handler 发 送 消 息 

Message msg = enw Message () ; 

= 0x1233; 


.sendMessage (msg) ; 


1, 


45 


{Ti 


肖 息 的 传递 ，Handler 类 位 于 android.os 包 下 。 


2-114 使 用 Handler 类 


SQLite 是 一 个 嵌入 式 SQL 数 据 库 引 擎 。 由 于 它 的 轻 量 级 本 质 ， 在 可 移动 设备 市 场 ，SQLite 成 为 各 种 平台 数据 库 应 用 的 首选 。 例 如 ， 苹 果 公 司 的 OS 和 谷歌 公司 的 Android 操 作 系 统 。 


SQLite 应 用 范围 非常 广泛 ， 可 以 当 作 应 用 程序 的 文件 格式 、 小 型 电子 设备 的 数据 库 ， 为 某 个 网 站 提供 数据 库 服务 ， 或 者 作为 企业 级 关系 型 数据 库 管理 系统 。SQLite 的 如 下 特性 使 得 它 被 各 种 设备 和 用 


所 选择 。 


“ RRE: SQLite 被 设计 为 不 需要 配置 文件 即 可 运行 ; 不 需要 安装 步骤 或 者 初始 安装 ; 不 需要 运行 服务 器 支持 ; 即使 SQLite 运 行 前 溃 ， 也 不 需要 回溯 步骤 。SQLite 运 行 时 没有 服务 器 支持 ， 而 是 直接 嵌入 
到 应 用 程序 中 。 甚 至 ， 它 不 需要 管理 员 创建 或 维护 数据 库 实 例 ， 或 者 为 用 户 设置 使 用 权限 。 简 而 言 之 ， 它 是 一 个 真正 的 无 数据 库 管 理 的 数据 库 。 


:自由 使 用 : SQLite 无 须 注 册 ， 自 由 使 用 。SQLite 的 源 代 码 已 开源 。 用 户 可 以 随意 修改 、 发 布 ， 甚 至 可 以 销售 。 
“ 跨 平 台 : 可 以 不 作 任何 修改 地 将 数据 库 文 件 从 一 个 系统 移动 到 另外 一 个 运行 着 不 同体 系 结构 的 系统 上 。 这 是 因为 数据 库 文件 格式 使 用 二 进 制 方式 ， 而 且 所 有 的 机 器 都 使 用 相同 的 格式 。 


ЖЖ: 一 个 SQLite 数 据 库 是 一 个 普通 的 磁盘 文件 ， 它 的 产生 不 需要 服务 器 支持 且 是 轻 量 级 和 简单 的 。 这 些 属性 导致 该 数据 库 引 擎 也 是 轻 量 级 的 。 


3.1.1 ” SQLite 体系 结构 


SQLite 由 三 个 部 分 组 成 : 内 核 、SQL 命 令 编译 器 和 后 端 。SQLite 的 体系 结构 如 图 3-1 所 示 。 


AT Wi] i 


SQL Ait > HEH и 


SQL AR uita 


虚拟 机 代码 生成 大 


操作 系统 接口 


图 3-1 SQLite 的 体系 结 


SQLite 体 系 结构 的 三 个 部 分 如 下 : 


1) SQLite 接 口 。 在 SQLite 库 栈 的 顶部 是 访问 SQLite 库 的 公共 接口 ， 大 部 分 包含 在 wen.c、legacy.c 和 vdbeapi.c 源 文件 中 。 它 们 成 为 与 其 他 程序 或 脚本 的 通信 接口 。 


2) SQL 编译 器 。 分 词 器 将 由 接口 传递 来 的 SQL 语句 字符 串 分 成 词语 ， 并 将 它们 逐个 交 给 语法 分 析 器 。 语 法 分 析 器 根据 分 词 建立 语法 树 ， 然 后 将 它 交 给 代码 生成 器 。 生 成 器 产生 虚拟 器 代码 并 交 给 虚拟 机 


3) SQLite 后 端 。B- 树 与 分 页 器 、 操 作 系统 接口 一 起 形成 了 SQLite 体 系 结构 的 后 端 。B- 树 用 来 组 织 数据 。 分 页 器 的 主要 目的 是 辅助 B- 树 ， 完 成 缓存 、 修 改 和 回 滚 数据 。 这 些 是 SQLite 的 内 部 细 
节 ，Android 应 用 程序 的 开发 人 员 不 必 担 心 Android 的 内 部 ， 因 为 SQLite Android 库 充分 利用 了 抽象 概念 一 一 隐藏 了 复杂 的 实现 过 程 。 开 发 人 员 只 需要 掌握 SQLite 提 供 的 AP1， 这 些 API 几 乎 可 以 满足 
Android 应 用 程序 对 SQLite 的 所 有 访问 。 


3.1.2 ”数据 库 基础 


数据 库 的 数据 逻辑 结构 是 采用 连续 方式 ， 物 理 结构 是 以 表格 的 方式 保存 数据 的 。 表 格 由 不 同 数据 类 型 列 组 成 ， 表 中 每 一 行 对 应 一 条 数据 记录 ， 可 以 将 表格 看 作 Excel 的 表单 。 从 面向 对 象 编程 的 角度 ， 每 
一 个 表格 通常 描述 一 个 对 象 (由 类 表示 ) 。 每 个 表 列 对 应 类 的 一 个 属性 ， 表 的 每 一 个 记录 代表 对 象 的 一 个 特殊 实例 。 


从 一 个 简单 例子 入 手 。 假 设 一 个 商店 数据 库 包含 一 个 货物 清单 表 。 该 表 用 来 保存 商店 中 所 有 的 商品 。 货 物 清单 表 可 能 包含 这 些 列 : 商品 名 称 (字符 串 ) 、 商 品 ID (数字 ) 、 价 格 (数字 ) 、 库 存 否 
峙 子 ， 如 表 3-1 所 示 。 


(0/1) 、 数 量 (数字 ) 。 可 以 通过 向 数据 库 中 增加 一 条 记录 来 表示 商店 新 增 一 种 商品 


ID 数量 
we | 3405 | o | 1 / 4 
2 2 


数据 库 中 的 数据 能 够 被 查询 和 更 改 ， 可 以 对 表 3-1 中 的 数据 进行 如 下 操作 : 


+ 增加 (使 用 INSERT 命 令 ) 


- 修改 (使 用 UPDATE 命 令 ) 


“ 删除 (使 用 DELETE 命 令 ) 


可 以 通过 查询 语句 查找 数据 库 中 特殊 的 数据 ， 查 询 语句 (使 用 SELETE 命 令 ) 的 查询 范围 可 以 是 一 张 表 或 多 张 表 。 为 了 产生 一 个 查询 结果 集 ， 必 须 通 过 SQL 语句 定位 表格 、 数 据 列 和 感 兴趣 的 数据 ， 每 一 
个 SQL 语句 都 以 分 号 作为 结束 符 。 


3.1.3 SQLite 语句 及 语法 


1.SQLite 语 句 


每 一 个 SQLite 语 句 都 是 一 个 符合 规范 的 SQL 语句 。SQL 语 句 用 来 对 数据 库 中 的 数据 进行 提取 、 创 建 、 插 入 、 更 新 或 删除 。 所 有 的 SQLite 语 句 都 是 以 这 些 关键 词 开始 的 : SELECT. INSERT, UPDATE, 
DELETE、ALTER、DROP 等 ， 所 有 的 语句 都 是 以 分 号 结束 。 例 如 : 


CREATE TABLE table name (column name INTEGER); 


命令 CREATE TABLE 是 用 来 在 SQLite 数 据 中 创建 新 表 的 ， 描 述 了 新 表 的 如 下 属性 : 


` 表 的 名 称 。 

` 表 所 在 的 数据 库 。 可 以 在 主 数据 库 、 临 时 数据 库 或 者 其 他 任何 加 载 的 数据 中 创建 表 。 

“ 表 中 每 一 个 列 的 名 称 。 

“ 表 中 每 一 个 列 的 数据 类 型 。 

“ 表 中 每 一 个 列 的 默认 值 或 表达 式 。 

“ 每 一 列 使 用 的 默认 关系 序列 。 

“ 表 的 主键 。 支 持 单列 或 组 合 〈 多 列 ) 主键 。 

| 为 每 一 个 表 设 置 SQL 约束。 约束 包括 : UNIQUE、NOTNULL、CHECK 和 FOREIGN KEY. 
“ 在 某 些 情况 下 ， 表 可 以 没有 ROWID。 


下 面 是 一 个 简单 的 创建 表 的 SQLite 语 句 的 例子 : 


String databaseTable = "CREATE TABLE " 
+ TABLE CONTACTS +"(" 
+ KEY ID 
+ " INTEGER PRIMARY KEY, " 
+ KEY NAME + " TEXT, " 
+ KEY NUMBER * " INTEGER" 
no 


Hh, CREATE TABLE 是 创建 表 名 为 TABLE CONTACTS 的 表 的 命令 。KEY ID、KEY_NAME 和 KEY_NUMBER 是 列 名 称 。SQLite 要 求 表 的 列 名 称 必须 是 唯一 的 。INTEGER 和 TEXT 是 对 应 列 的 数据 类 型 。 
SQLite 要 求 保存 列 的 数据 类 型 必须 在 创建 表 时 定义 。PRIMARY KEY 是 数据 列 约束 (为 表 的 数据 列强 加 的 约束 ) 。 


SQLite 在 创建 表 时 支持 更 多 的 特性 ， 例 如 ， 可 以 为 空 列 指定 默认 值 。 下 面 的 创建 表 的 语句 中 ， 为 列 KEY_NAME 指 定 了 默认 值 “xyz”， 为 列 KEY_NUMER 指 定 了 默认 值 “100”。 


String databaseTable = 

"CREATE TABLE " 

+ TABLE CONTACTS + "(" 

+ KEY ID + " INTEGER PRIMARY KEY, " 

+ КЕҮ МАМЕ + " TEXT DEFAULT xyz, " 

+ KEY_NUMBER + " INTEGER DEFAULT 100" + ")"; 


在 创建 向 数据 库 插入 一 行 数据 的 SQL 语句 时 ， 这 些 列 会 被 默认 值 预 初始 化 。 


2.SQLite 语 法 


SQLite 对 SQLite 语 句 是 不 区 分 字母 大 小 写 的 。 但 是 在 一 些 命令 中 例外 ， 如 GLOB 与 glob 具 有 不 同 的 意思 。 一 般 情况 下 ， 可 以 不 考虑 字母 大 小 写 的 区 别 ， 下 面 是 一 个 SQLite 删 除 语句 语 法 结构 ， 如 果 将 语 
句 中 的 大 写字 母 用 小 写 代替 ， 并 不 影响 SQLite 对 该 语句 的 执行 。 


DELETE FROM table WHERE {condition}; 


3.SQLite 的 数据 类 型 


SQLite 使 用 动态 的 、 弱 类 型 的 SQL 语法 ，Java 是 静态 类 型 的 语言 ， 而 Python 则 是 动态 类 型 的 语言 。 通 过 如 下 例子 了 解 动态 类 型 与 静态 类 型 的 


xl 
un 
= 


a=5 
a ="Android" 


在 静态 类 型 语言 中 ， 上 面 的 语句 会 抛 出 异常 ， 而 在 动态 类 型 的 语言 则 不 会 。 在 SQLite 中 数值 的 数据 类 型 并 不 与 保存 该 数值 的 容器 相关 ， 而 只 与 值 本 身 相 关 。 由 于 SQLite 向 后 兼容 普通 的 静态 类 型 系统 ， 
因此 ， 在 静态 系统 中 使 用 的 SQL 语 句 也 能 在 SQLite 中 使 用 。 


SQLite 使 用 比 数据 类 型 更 一 般 的 存储 类 型 。SQLite 将 数据 值 的 存储 划分 为 以 下 五 种 存储 类 型 : 


- NULL: 表示 对 应 的 数据 没有 数值 。 


` INTEGER: 表示 对 应 的 数据 为 整数 。 支 持 宽度 分 别 为 1、2、3、4、6 和 8 字 节 ， 该 宽度 是 SQLite 根 据 实际 保存 的 数值 自动 处 理 的 。 如 果 该 数据 要 在 计算 机 内 存 中 处 理 时 ， 它 们 会 被 转换 为 更 一 般 的 8 字 
节 有 符号 整数 形式 。 


- REAL: 浮 点 类 型 ，SQLite 使 用 8 字 节 宽度 的 IEEE 浮 点 数 来 保存 这 种 数值 。 


- TEXT: SQLite 支 持 多 种 字符 编码 的 字符 串 ， 如 UTF-8、UTF-16BE 和 UTR-16LE。 


‘BLOB: 该 类 型 存储 长 的 二 进 制 数据 。 


SQLite 本 身 不 会 检查 写 入 数据 列 中 的 数据 类 型 是 否 与 表 中 定义 的 列 类 型 一 致 。 例 如 ， 可 以 把 一 个 整数 写 入 定义 为 字符 串 类 型 的 列 中 ， 反 之 亦 然 ， 甚 至 ， 表 3-2 中 的 某 一 列 可 以 使 用 不 同 存储 类 。 


+3-2 某 一 列 使 用 不 同 存储 类 


Id Clo_t 
l 23 

2 Null 
3 test 


SQLite 不 存在 独立 的 保存 布尔 类 型 的 类 ， 而 是 使 用 整 型 来 代替 。 整 数 0 表示 false， 而 1 表示 true， 这 意味 着 SQLite 间 接 支持 布尔 类 型 ， 在 实际 使 用 中 不 能 使 用 熟知 的 true/false， 而 是 使 用 1/0 代 替 。 


与 布尔 类 型 一 样 ，SQLite 同 样 也 不 支持 日 期 和 时 间 数 据 类 型 。SQLite 提 供 了 5 个 内 置 的 日 期 和 时 间 函 数 帮助 处 理 日 期 和 时 间 数 据 ， 可 以 将 数据 看 作 整 型 、 字 符 串 和 浮 点 型 来 处 理 。 为 了 计算 当前 日 期 ， 
使 用 如 下 的 代码 : 


SELECT date ('now'); 


4.SQLite 的 版 本 


Android 从 API 1 开始 就 内 置 了 SQLite。 截 至 本 书 完结 时 SQLite 的 版 本 为 3.8.9， 官 方 网 站 为 http://www.sqlite.org/。 图 3-2 为 SQLite 的 官方 网 站 主页 ， 可 以 从 该 网 站 下 载 最 新 的 SQLite 软 件 ， 也 可 以 查 
阅 相 关 文 档 等 。 不 同 版 本 的 Android 系 统 内置 了 不 同 版 本 的 SQLite。 用 户 非常 容易 查询 自己 使 用 的 Android 系 统 中 的 SQLite 版 本 。 
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SQLite is a software library that implements a self-contained, • Version 3.8.9 of SQLite is recommended for 
all new development. Upgrading from 

versions 3.8.8.x is optional. Upgrading from 
all other versions of SQLite is recommended. 


serverless, zero-configuration, transactional SQL database engine. 


SQLite is the most widely deployed SQL database engine in the world. 
The source code for SQLite is in the public domain. 
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图 3-2 ”SQLite 的 官方 网 站 主页 


3.14 数据 库 包 


android.database 包 中 包含 了 所 有 与 数据 库 相 关 的 、 必 需 的 类 。android.database.SQLite 包 中 包含 指定 为 SQLite 使 用 的 类 。 


Android 系 统 提供 了 丰富 的 AP1， 用 来 创建 、 访 问 、 修 改 和 删除 数据 库 。 为 了 简便 的 缘故 ， 在 此 只 列 出 最 重要 的 一 些 类 。 


Features 
When to use SQLite 
Frequently Asked Questions 
Well-known Users 
Getting Started 
SOL Syntax 

o Pragmas 

o SQL functions 

o Date & time functions 

o Aggregate functions 
C/C++ Interface Spec 

o Introduction 

o List of C-language APIs 
The TCL Interface Spec 
Development Timeline 
Report a Bug 


SQLiteOpenHelper 类 是 Android 系 统 中 操作 SQLite 数 据 库 最 核心 的 类 ， 它 出 现在 android.database.SQLite 名 字 空 间 中 。SQLiteOpenHelper 是 SQLiteDatabse 的 一 个 帮助 类 ， 用 来 管理 数据 的 创建 和 


版 本 更 新 。 


SQLiteOpenHelper (Context context, String name, SQLiteDatabase.CursorFactory factory, int version) 


SQLiteOpenHelper (Context context, String name, SQLiteDatabase.CursorFactory factory, int version, DatabaseErrorHandler errorHandler) 


参数 name 由 Android 存 储 系统 中 的 数据 库 文 件 名 称 组 成 。SQLiteDatabase.CursorFactory 是 创建 游标 对 象 的 工厂 类 。 游 标 对 象 充 当 查询 SQLite 的 结果 集 。 


SQLiteOpenHelper 的 构造 函数 创建 一 个 帮助 对 象 ， 利 用 它 可 以 创建 、 打 开 和 管理 数据 库 。 参 数 context 是 能 够 访问 所 有 共享 资源 的 应 
在 的 数据 库 ) 。SQLiteDatabase.CursorFactory 工 厂 创建 一 个 游标 对 象 ， 表 示 查 询 数 据 库 的 结果 集 。 参 数 version 定 义 了 数据 库 的 版 本 号 。 在 第 二 个 构造 函数 中 ， 参 数 errorHandler 


报告 数据 库 出 错 的 原因 。 
类 SQLiteOpenHelper 中 重要 的 方法 有 : 
* synchronized void close() 
+ synchronized SQLiteDatabase getReadableDatabase() 
` synchronized SQLiteDatabase getWritableDatabase() 
abstract void onCreate(SQLiteDatabase db) 
* void onOpen(SQLiteDatabase db) 


* abstract void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 


其 中 ， 方 法 synchronized close() 关 闭 任何 打开 的 数据 库 对 象 。 关 键 词 synchronized 用 来 阻止 线程 和 内 存 的 一 致 性 错误 。 


程序 。 参 数 name 或 者 是 数据 库 的 名 称 或 者 是 空 (代表 内 存 中 存 


来 在 数据 库 骨 省 时 ， 


方法 getReadableDatabase(0 和 getWritableDatabase() 用 于 打开 与 创建 数据 库 。 它 们 都 返回 SQLiteDatabasae 对 象 ; 不 同 之 处 在 于 getReadableDatabase( 返 回 一 个 可 读 的 数据 库 对象 ， 而 
getWritableDatabase() 返 回 一 个 可 写 的 数据 库 对 象 。getWritableDatabase() 方 法 在 执行 的 过 程 中 ， 如 果 不 能 打开 一 个 可 写 的 数据 ， 会 抛 出 一 个 SQLiteException 异 常 。 


使 用 SQLiteDatabase 类 的 方法 isReadOnly() 查 询 数据 库 的 读 写 状 态 ， 如 果 数 据 库 是 只 读 的 ， 则 返回 true。 


如 果 数 据 库 本 身 不 存在 ， 调 用 任意 一 个 方法 将 会 3 起 对 onCreate() 的 调用 ， 否 则 将 会 调用 onOpen0 和 onUpgrade() 方 法 ， 最 终 调用 哪个 方法 由 版 本 号 决定 。onUpgrade() 在 更 新 数据 之 前 ， 会 通过 调 有 
isReadOnly() 方 法 检测 数据 库 的 状态 。 一 旦 数据 库 打开 ， 数 据 库 会 在 内 存 中 建立 缓存 映像 以 提高 数据 库 的 性 能 ， 所 有 打开 的 数据 库 对 象 都 需要 通过 close() 方 法 关闭 。 


当 首 次 创建 数据 库 的 同时 会 调用 onCreate()， 所 以 在 方法 中 创建 数据 库 表 是 非常 好 的 选择 。 在 配置 数据 库 、 建 立 数据 库 方案 或 升级 数据 库 时 调用 onOpen() 方 法 。 升 级 数据 库 时 ， 调 用 onUpgrade() 方 
法 。 默 认 情 况 下 ， 数 据 库 版 本 为 1， 如 果 增 加 数据 库 版 本 号 并 发 布 新 的 版 本 ， 将 会 执行 数据 库 升 级 。 下 面 是 一 个 使 用 SQLiteOpenHelper 类 操作 数据 库 的 简单 示例 : 


class SQLiteHelperClass 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public static final int VERSION NUMBER = 1; 

sqlHelper = new SQLiteOpenHelper (context, "ContactDatabase", null, VERSION_NUMBER) { 

@Override 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

// 删除 表格 

db.execSQL("DROP TABLE IF EXISTS "+ TABLE CONTACTS) ; 

// 重新 创建 表格 

onCreate (db) ; 

} 


GOverride 

public void onCreate (SQLiteDatabase db) { 

// 创建 表格 

String createContactsTable ="CREATE TABLE "+ TABLE CONTACTS + "("+ KEY ID + " INTEGER PRIMARY KEY, "+ KEY NAME + " TEXT, "+ KEY NUMBER + " INTEGER" + ")"; 
try { 


db.execSQL (createContactsTable) ; 
} catch (SQLException e) { 
e.printStackTrace () ; 
} 
} 
GOverride 
public synchronized void close() { 
super.close(); 
Log.d("TAG", "Database closed"); 


GOverride 
public void onOpen(SQLiteDatabase db) { 
super .onOpen (db) ; 
Log.d("TAG", "Database opened"); 
} 
1; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
// 以 只 读 方式 打开 数据 库 
SQLiteDatabase db = SQLiteOpenHelper.getWritableDatabase () ; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
// 以 读 写 方式 打开 数据 库 
SQLiteDatabase db = SQLiteOpenHelper.getWritableDatabase () ; 


3.1.5 SQLiteDatabase 类 


通过 以 上 内 容 的 介绍 ， 读 者 对 利用 SQLiteOpenHelper 类 操作 数据 有 了 一 个 较为 清晰 的 认识 ， 接 下 来 将 介绍 核心 类 SQLiteDatabase。SQLiteDatabase 是 在 Android 中 操作 SQLite 数 据 库 所 要 求 的 最 基 
本 的 类 ， 包 括 的 主要 操作 有 打开 、 查 询 、 升 级 和 关闭 数据 库 。 


SQLiteDatabase 类 包括 50 多 个 方法 ， 每 一 个 方法 都 有 自己 的 语义 和 使 用 方法 。 下 面 列 出 最 常用 和 最 重要 的 方法 : 


= 


ublic long insert(String table, String nullColumnHack, ContentValues values) 


ublic Cursor query(String table, String{Jcolumns, String selection, String[|selectionArgs, String groupBy, String having, String orderBy) 


ublic Cursor rawQuery(String sql, String[]selectionArgs) 


ublic int delete(String table, String whereClause, String[]whereArgs) 


= 


ublic int update(String table, ContentValues values, String whereClause, String[]whereArgs) 


在 下 面 的 例子 中 ， 向 数据 库 表 中 插入 名 称 和 数字 ， 以 便利 用 查询 语句 从 表 中 提取 数据 。 之 后 ， 通 过 delete0 和 update() 方 法 以 ID 作为 参数 标识 要 删除 或 更 新 的 数据 。 


public void insertToSimpleDataBase () 
{ 

SQLiteDatabase db = sqlHelper.getWritableDatabase () ; 

ContentValues cv = new ContentValues(); 

cv.put(KEY NAME, "John"); 

cv.put(KEY NUMBER, "0000000000"); 

// 利用 ContentValues 对 象 向 表 中 插入 不 同 列 

db.insert (TABLE CONTACTS, null, cv); 

cv = new ContentValues () ; 

cv.put(KEY NAME, "Tom"); 

cv.put(KEY NUMBER, "5555555"); 

// 利用 ContentValues 对 象 向 表 中 插入 不 同 列 

db.insert (TABLE CONTACTS, null, cv); 
} http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public void getDataFromDatabase () Е 
1 

int count; 

db = sqlHelper.getReadableDatabase () ; 

// 使 用 查询 语句 提取 数据 

Cursor cr = db. query(TABLE CONTACTS, null, null, null, null, null, null); 

if(cr != null) { 

count = cr.getCount (); 
Log.d("DATABASE", "count is : " + count); 


l 
// 使 用 查询 语句 提取 数据 
cr = db.rawQuery("select * from " + TABLE CONTACTS, null); 
if(cr != null) í ~ 
count = cr.getCount (); 
Log.d("DATABASE", "count is : " + count); 


] 
} http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public void delete (String name) 
{ 

String whereClause = KEY_NAME + "="; 

String[] whereArgs = new String[] {name}; 

db = sqlHelper.getWritableDatabase () ; 

int rowsDeleted = db.delete (TABLE CONTACTS, whereClause, whereArgs) ; 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public void update (String name) 
{ 

String whereClause = KEY NAME + "="; 

String[] whereArgs new String[] {name}; 

ContentValues cv = new ContentValues(); 


cv.put (KEY NAME, "Betty"); 

cv.put (KEY NUMBER, 999000") ; 

db = sqlHelper.getWritableDatabase () ; 

int rowsUpdated = db.update (TABLE CONTACTS, cv, whereClause, whereArgs) ; 
} 


ContentValues 本 质 上 就 是 键 - 值 对 的 集合 ， 其 中 ， 键 代表 表 的 列 ， 值 代表 向 表格 插入 的 数值 。 例 如 ，values.put("COL_1"，1) 的 情况 ， 表 示 在 列 COL_1 中 插入 值 1。 向 数据 库 表 中 插入 “姓名 ”和 “ 数 
”字段 代码 如 下 : 


+ 


ContentValues cv = new ContentValues(); 
cv.put (COL_NAME, "john doe"); 

cv.put (COL NUMBER, "12345000"); 

dataBase. insert (TABLE CONTACTS, null, cv); 


查询 产生 游标 对 象 。 游 标 对 象 代表 了 查询 结果 ， 基 本 上 是 指向 查询 结果 集 的 一 行 数据 。 可 以 利用 getCount() 方 法 ， 获 得 查询 结果 集中 的 元 素 个 数 。 为 了 访问 结果 集中 的 某 个 数据 行 ， 可 以 使 
moveToFirst0 和 moveToNext() 方 法 。isAfterLast() 方 法 可 以 帮助 用 户 判 断 当前 指针 是 否 已 指向 最 后 一 条 数据 行 。 


游标 对 象 提供 了 一 系列 访问 数据 元 素 的 方法 ， 这 些 方法 具有 类 似 的 形式 : get*(0。 例 如 getLong(columnlndex) 方 法 和 getstring(columnlndex) 方 法 可 以 从 一 行 数据 中 抽取 对 应 列 数据 ，columnlndex 
是 将 要 访问 列 索引 。 游 标 对 象 也 提供 一 个 通过 表 列 名 查询 列 索引 的 方法 ，getColumnlndexOrThrow(string)。 利 用 这 些 接口 ， 用 户 可 以 随机 读 写 访问 结果 集 。 查 询 结果 的 游标 指针 指向 第 0 个 位 置 ， 该 位 置 
存放 结果 集中 的 第 一 条 记录 。 


第 3 章 ”SQLite 数 据 库 程序 开发 


3.1 SQLite 简 介 


SQLite 是 一 个 谋 入 式 SQl 数据库 引擎 。 由 于 它 的 轻 量 级 本 质 ， 在 可 移动 设备 市 场 ，SQLite 成 为 各 种 平台 数据 库 应 用 的 首选 。 例 如 ， 苹 果 公司 的 jiOS 和 谷歌 公司 的 Android 操 作 系统 。 


SQLite 应 用 范围 非常 广泛 ， 可 以 当 作 应 用 程序 的 文件 格式 、 小 型 电子 设备 的 数据 库 ， 为 某 个 网 站 提供 数据 库 服务 ， 或 者 作为 企业 级 关系 型 数据 库 管理 系统 。SQLite 的 如 下 特性 使 得 它 被 各 种 设备 和 用 户 
所 选择 。 


“ BACH: SQLite 被 设计 为 不 需要 配置 文件 即 可 运行 ; 不 需要 安装 步骤 或 者 初始 安装 ; 不 需要 运行 服务 器 支持 ; 即使 SQLite 运 行 前 渍 ， 也 不 需要 回溯 步骤 。SQLite 运 行 时 没有 服务 器 支持 ， 而 是 直接 谨 入 
到 应 用 程序 中 。 甚 至 ， 它 不 需要 管理 员 创 建 或 维护 数据 库 实例 ， 或 者 为 用 户 设置 使 用 权限 。 简 而 言 之 ， 它 是 一 个 真正 的 无 数据 库 管 理 的 数据 库 。 


“ 自由 使 用 : SQLite 无 须 注 册 ， 自 由 使 用 。SQLite 的 源 代 码 已 开源 。 用 户 可 以 随意 修改 、 发 布 ， 甚 至 可 以 销售 。 
“ 跨 平 台 : 可 以 不 作 任何 修改 地 将 数据 库 文 件 从 一 个 系统 移动 到 另外 一 个 运行 着 不 同体 系 结构 的 系统 上 。 这 是 因为 数据 库 文件 格式 使 用 二 进 制 方式 ， 而 且 所 有 的 机 器 都 使 用 相同 的 格式 。 


ЖЖ: 一 个 SQLite 数 据 库 是 一 个 普通 的 磁盘 文件 ， 它 的 产生 不 需要 服务 器 支持 且 是 轻 量 级 和 简单 的 。 这 些 属性 导致 该 数据 库 引 擎 也 是 轻 量 级 的 。 


3.1.1 SQLite 体 系 结构 


SQLite 由 三 个 部 分 组 成 : 内 核 、SQL 命 令 编译 器 和 后 端 。SQLite 的 体系 结构 如 图 3-1 所 示 。 


SQLite (AR 


1) SQLite 接 | 


2) SQL 编译 器 。 分 词 器 将 由 接口 传递 来 的 SQL 语句 字符 串 分 成 词语 ， 并 将 它们 逐个 交 给 语法 分 析 器 。 语 法 分 析 器 根据 分 词 建立 语法 树 ， 然 后 将 它 交 : 


执行 。 


虚拟 机 


图 3-1 SQLite 的 体系 结构 


结构 的 三 个 部 分 如 下 : 


3) SQLite 后 端 。B- 树 与 分 页 器 、 操 作 系统 接口 一 起 形成 了 SQLite 体 系 结构 的 后 端 。B- 树 用 来 组 织 数据 。 分 页 器 的 主要 


节 ，Android 应 


FORE X d 


。 在 SQLite 库 栈 的 顶部 是 访问 SQLite 库 的 公共 接口 ， 大 部 分 包含 在 wen.c、legacy.c 和 vdbeapi.c 源 文件 中 。 它 们 成 为 与 其 他 程序 或 脚本 的 通信 接口 。 


的 是 辅助 B- 树 ， 


程序 的 开发 人 员 不 必 担 心 Android 的 内 部 ， 因 为 SQLite Android 库 充分 利用 了 抽象 概念 一 一 隐藏 了 复杂 的 实现 过 程 。 开 发 人 员 只 需要 掌握 SQLite 提 供 的 AP|， 


Android 应 用 程序 对 SQLite 的 所 有 访问 。 


3.1.2 ”数据 库 基 础 


数据 库 的 数据 逻辑 结构 是 采用 连续 方式 ， 物 理 结构 是 以 表格 的 方式 保存 数据 的 。 表 格 由 不 同 数据 类 型 列 组 成 ， 表 中 每 一 行 对 应 一 条 数据 记录 ， 可 以 将 表格 看 作 Excel 的 表单 。 从 天 


完成 缓存 、 


修改 和 回 滚 数 


给 代码 生成 器 。 生 成 器 产生 虚拟 器 代码 并 交 给 虚拟 机 


居 。 这 些 是 SQLite 的 内 部 细 
这 些 API 几 乎 可 以 满足 


向 对 象 编程 的 角度 ， 每 


一 个 表格 通常 描述 一 个 对 象 (由 类 表示 ) 。 每 个 表 列 对 应 类 的 一 个 属性 ， 表 的 每 一 个 记录 代表 对 象 的 一 个 特殊 实例 。 


从 一 个 简单 例子 入 手 。 假 设 一 个 商店 数据 库 包含 一 个 货物 清单 表 。 该 表 用 来 保存 商店 中 所 有 的 商品 。 货 物 清单 表 可 能 包含 这 些 列 : 商品 名 称 (字符 串 ) 、 商 品 ID (数字 ) 、 价 格 (数字 ) 、 库 存 否 
(0/1) 、 数 量 (数字 ) 。 可 以 通过 向 数据 库 中 增加 一 条 记录 来 表示 商店 新 增 一 种 商品 一 一 鞋子 ， 如 表 3-1 所 示 。 


表 3-1 数据 库 基 表 


数据 库 中 的 数据 能 够 被 查询 和 更 改 ， 可 以 对 表 3-1 中 的 数据 进行 如 下 操作 : 
“ 增加 (使 用 INSERT 命 令 ) 
“ 修改 (使 用 UPDATE 命 令 ) 


“ 删除 (使 用 DELETE 命 令 ) 


可 以 通过 查询 语句 查找 数据 库 中 特殊 的 数据 ， 查 询 语句 (使 用 SELETE 命 令 ) 的 查询 范围 可 以 是 一 张 表 或 多 张 表 。 为 了 产生 一 个 查询 结果 集 ， 必 须 通 过 SQL 语句 定位 表格 、 数 据 列 和 感 兴趣 的 数据 ， 每 一 
个 SQL 语句 都 以 分 号 作为 结束 符 。 


3.1.3” SQLite 语句 及 语法 


1.SQLite 语 句 


每 一 个 SQLite 语 句 都 是 一 个 符合 规范 的 SQL 语句 。SQL 语 句 用 来 对 数据 库 中 的 数据 进行 提取 、 创 建 、 插 入 、 更 新 或 删除 。 所 有 的 SQLite 语 句 都 是 以 这 些 关键 词 开始 的 : SELECT. INSERT, UPDATE, 
DELETE、ALTER、DROP 等 ， 所 有 的 语句 都 是 以 分 号 结束 。 例 如 : 


CREATE TABLE table name (column name INTEGER); 


命令 CREATE TABLE 是 用 来 在 SQLite 数 据 中 创建 新 表 的 ， 描 述 了 新 表 的 如 下 属性 : 


` 表 的 名 称 。 

` 表 所 在 的 数据 库 。 可 以 在 主 数 据 库 、 临 时 数据 库 或 者 其 他 任何 加 载 的 数据 中 创建 表 。 

“ 表 中 每 一 个 列 的 名 称 。 

E 表 中 每 一 个 列 的 数据 类 型 。 

“ 表 中 每 一 个 列 的 默认 值 或 表达 式 。 

“ 每 一 列 使 用 的 默认 关系 序列 。 

“ 表 的 主键 。 支 持 单列 或 组 合 ( 多 列 ) 主键 。 

- 为 每 一 个 表 设置 8QL 约 束 。 约 束 包括 : UNIQUE, NOT NULL、CHECK 和 FOREIGN KEY. 
在 某 些 情况 下 ， 表 可 以 没有 ROWID。 


下 面 是 一 个 简单 的 创建 表 的 SQLite 语 句 的 例子 : 


String databaseTable = "CREATE TABLE " 
+ TABLE CONTACTS +"(" 
+ KEY_ID 
+ " INTEGER PRIMARY KEY, " 
+ KEY NAME + " TEXT, " 
+ KEY NUMBER + " INTEGER" 
+ "у" 


Hh, CREATE TABLE 是 创建 表 名 为 TABLE CONTACTS 的 表 的 命令 。KEY ID、KEY_NAME 和 KEY_NUMBER 是 列 名 称 。SQLite 要 求 表 的 列 名 称 必须 是 唯一 的 。INTEGER 和 TEXT 是 对 应 列 的 数据 类 型 。 
SQLite 要 求 保存 列 的 数据 类 型 必须 在 创建 表 时 定义 。PRIMARY KEY 是 数据 列 约束 (为 表 的 数据 列强 加 的 约束 ) 。 


SQLite 在 创建 表 时 支持 更 多 的 特性 ， 例 如 ， 可 以 为 空 列 指定 默认 值 。 下 面 的 创建 表 的 语句 中 ， 为 列 KEY_NAME 指 定 了 默认 值 “xyz”， 为 列 KEY_NUMER 指 定 了 默认 值 “100”。 


String databaseTable = 

"CREATE TABLE " 

+ TABLE CONTACTS + "(" 

+ KEY ID + " INTEGER PRIMARY KEY, " 

+ KEY NAME + " TEXT DEFAULT xyz, " 

+ KEY_NUMBER + " INTEGER DEFAULT 100" + ")"; 


在 创建 向 数据 库 插入 一 行 数据 的 SQL 语句 时 ， 这 些 列 会 被 默认 值 预 初始 化 。 


2.SQLite 语 法 


SQLite 对 SQLite 语 句 是 不 区 分 字母 大 小 写 的 。 但 是 在 一 些 命令 中 例外 ， 如 GLOB 与 glob 具 有 不 同 的 意思 。 一 般 情况 下 ， 可 以 不 考虑 字母 大 小 写 的 区 别 ， 下 面 是 一 个 SQLite 删 除 语句 语 法 结构 ， 如 果 将 语 
句 中 的 大 写字 母 用 小 写 代 蔡 ， 并 不 影响 SQLite 对 该 语句 的 执行 。 


DELETE FROM table WHERE {condition}; 


3.SQLite 的 数据 类 型 


SQLite 使 用 动态 的 、 弱 类 型 的 SQL 语法 ，Java 是 静态 类 型 的 语言 ， 而 Python 则 是 动态 类 型 的 语言 。 通 过 如 下 例子 了 解 动态 类 型 与 静态 类 型 的 区 


un 
c 


在 静态 类 型 语言 中 ， 上 面 的 语句 会 抛 出 异常 ， 而 在 动态 类 型 的 语言 则 不 会 。 在 SQLite 中 数值 的 数据 类 型 并 不 与 保存 该 数值 的 容器 相关 ， 而 只 与 值 本 身 相关 。 由 于 SQLite 向 后 兼容 普通 的 静态 类 型 系统 ， 
因此 ， 在 静态 系统 中 使 用 的 SQL 语句 也 能 在 SQLite 中 使 用 。 


SQLite 使 用 比 数据 类 型 更 一 般 的 存储 类 型 。SQLite 将 数据 值 的 存储 划分 为 以 下 五 种 存储 类 型 : 


| NULL: 表示 对 应 的 数据 没有 数值 。 


“INTEGER: 表示 对 应 的 数据 为 整数 。 支 持 宽度 分 别 为 1、2、3、4、6 和 8 字 节 ， 该 宽度 是 SQLite 根 据 实际 保存 的 数值 自动 处 理 的 。 如 果 该 数据 要 在 计算 机 内 存 中 处 理 时 ， 它 们 会 被 转换 为 更 一 般 的 8 字 
节 有 符号 整数 形式 。 


` REAL: 浮 点 类 型 ，SQLite 使 用 8 字 节 宽度 的 IEEE 浮 点 数 来 保存 这 种 数值 。 
. TEXT: SQLite 支 持 多 种 字符 编码 的 字符 串 ， 如 UTF-8、UTF-16BE 和 UTR-16LE。 


: BLOB: 该 类 型 存储 长 的 二 进 制 数据 。 


SQLite 本 身 不 会 检查 写 入 数据 列 中 的 数据 类 型 是 否 与 表 中 定义 的 列 类 型 一 致 。 例 如 ， 可 以 把 一 个 整数 写 入 定义 为 字符 串 类 型 的 列 中 ， 反 之 亦 然 ， 甚 至 ， 表 3-2 中 的 某 一 列 可 以 使 用 不 同 存储 类 。 


表 3-2 某 一 列 使 用 不 同 存储 类 


Id Clo_t 
l 23 

2 Null 
3 test 


SQLite 不 存在 独立 的 保存 布尔 类 型 的 类 ， 而 是 使 用 整 型 来 代替 。 整 数 0 表示 false， 而 1 表示 true， 这 意味 着 SQLite 间 接 支持 布尔 类 型 ， 在 实际 使 用 中 不 能 使 用 熟知 的 true/false， 而 是 使 用 1/0 代 替 。 


与 布尔 类 型 一 样 ，SQLite 同 样 也 不 支持 日 期 和 时 间 数 据 类 型 。SQLite 提 供 了 5 个 内 置 的 日 期 和 时 间 函 数 帮助 处 理 日 期 和 时 间 数 据 ， 可 以 将 数据 看 作 整 型 、 字 符 串 和 浮 点 型 来 处 理 。 为 了 计算 当前 日 期 ， 
使 用 如 下 的 代码 : 


SELECT date('now'); 


4.SQLite 的 版 本 


Android 从 API 1 开始 就 内 置 了 SQLite。 截 至 本 书 完结 时 SQLite 的 版 本 为 3.8.9， 官 方 网 站 为 http://www.sqlite.org/。 图 3-2 为 SQLite 的 官方 网 站 主页 ， 可 以 从 该 网 站 下 载 最 新 的 SQLite 软 件 ， 也 可 以 查 
阅 相 关 文 档 等 。 不 同 版 本 的 Android 系 统 内 置 了 不 同 版 本 的 SQLite。 用 户 非常 容易 查询 自己 使 用 的 Android 系 统 中 的 SQLite 版 本 。 
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SQLite is a software library that implements a self-contained, • Version 3.8.9 of SQLite is recommended for 
all new development. Upgrading from 

versions 3.8.8.x is optional. Upgrading from 
all other versions of SQLite is recommended. 


serverless, zero-configuration, transactional SQL database engine. 


SQLite is the most widely deployed SQL database engine in the world. 
The source code for SQLite is in the public domain. 
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图 3-2 ”SQLite 的 官方 网 站 主页 


3.14 数据 库 包 


android.database 包 中 包含 了 所 有 与 数据 库 相 关 的 、 必 需 的 类 。android.database.SQLite 包 中 包含 指定 为 SQLite 使 用 的 类 。 


Android 系 统 提供 了 丰富 的 AP1， 用 来 创建 、 访 问 、 修 改 和 删除 数据 库 。 为 了 简便 的 缘故 ， 在 此 只 列 出 最 重要 的 一 些 类 。 


Features 
When to use SQLite 
Frequently Asked Questions 
Well-known Users 
Getting Started 
SOL Syntax 

o Pragmas 

o SQL functions 

o Date & time functions 

o Aggregate functions 
C/C++ Interface Spec 

o Introduction 

o List of C-language APIs 
The TCL Interface Spec 
Development Timeline 
Report a Bug 


SQLiteOpenHelper 类 是 Android 系 统 中 操作 SQLite 数 据 库 最 核心 的 类 ， 它 出 现在 android.database.SQLite 名 字 空 间 中 。SQLiteOpenHelper 是 SQLiteDatabse 的 一 个 帮助 类 ， 用 来 管理 数据 的 创建 和 


版 本 更 新 。 


SQLiteOpenHelper (Context context, String name, SQLiteDatabase.CursorFactory factory, int version) 


SQLiteOpenHelper (Context context, String name, SQLiteDatabase.CursorFactory factory, int version, DatabaseErrorHandler errorHandler) 


参数 name 由 Android 存 储 系统 中 的 数据 库 文 件 名 称 组 成 。SQLiteDatabase.CursorFactory 是 创建 游标 对 象 的 工厂 类 。 游 标 对 象 充 当 查询 SQLite 的 结果 集 。 


SQLiteOpenHelper 的 构造 函数 创建 一 个 帮助 对 象 ， 利 用 它 可 以 创建 、 打 开 和 管理 数据 库 。 参 数 context 是 能 够 访问 所 有 共享 资源 的 应 
在 的 数据 库 ) 。SQLiteDatabase.CursorFactory 工 厂 创建 一 个 游标 对 象 ， 表 示 查 询 数 据 库 的 结果 集 。 参 数 version 定 义 了 数据 库 的 版 本 号 。 在 第 二 个 构造 函数 中 ， 参 数 errorHandler 


报告 数据 库 出 错 的 原因 。 
类 SQLiteOpenHelper 中 重要 的 方法 有 : 
* synchronized void close() 
+ synchronized SQLiteDatabase getReadableDatabase() 
` synchronized SQLiteDatabase getWritableDatabase() 
abstract void onCreate(SQLiteDatabase db) 
* void onOpen(SQLiteDatabase db) 


* abstract void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 


其 中 ， 方 法 synchronized close() 关 闭 任何 打开 的 数据 库 对 象 。 关 键 词 synchronized 用 来 阻止 线程 和 内 存 的 一 致 性 错误 。 


程序 。 参 数 name 或 者 是 数据 库 的 名 称 或 者 是 空 (代表 内 存 中 存 


来 在 数据 库 骨 省 时 ， 


方法 getReadableDatabase(0 和 getWritableDatabase() 用 于 打开 与 创建 数据 库 。 它 们 都 返回 SQLiteDatabasae 对 象 ; 不 同 之 处 在 于 getReadableDatabase( 返 回 一 个 可 读 的 数据 库 对象 ， 而 
getWritableDatabase() 返 回 一 个 可 写 的 数据 库 对 象 。getWritableDatabase() 方 法 在 执行 的 过 程 中 ， 如 果 不 能 打开 一 个 可 写 的 数据 ， 会 抛 出 一 个 SQLiteException 异 常 。 


使 用 SQLiteDatabase 类 的 方法 isReadOnly() 查 询 数据 库 的 读 写 状 态 ， 如 果 数 据 库 是 只 读 的 ， 则 返回 true。 


如 果 数 据 库 本 身 不 存在 ， 调 用 任意 一 个 方法 将 会 3 起 对 onCreate() 的 调用 ， 否 则 将 会 调用 onOpen0 和 onUpgrade() 方 法 ， 最 终 调用 哪个 方法 由 版 本 号 决定 。onUpgrade() 在 更 新 数据 之 前 ， 会 通过 调 有 
isReadOnly() 方 法 检测 数据 库 的 状态 。 一 旦 数据 库 打开 ， 数 据 库 会 在 内 存 中 建立 缓存 映像 以 提高 数据 库 的 性 能 ， 所 有 打开 的 数据 库 对 象 都 需要 通过 close() 方 法 关闭 。 


当 首 次 创建 数据 库 的 同时 会 调用 onCreate()， 所 以 在 方法 中 创建 数据 库 表 是 非常 好 的 选择 。 在 配置 数据 库 、 建 立 数据 库 方案 或 升级 数据 库 时 调用 onOpen() 方 法 。 升 级 数据 库 时 ， 调 用 onUpgrade() 方 
法 。 默 认 情 况 下 ， 数 据 库 版 本 为 1， 如 果 增 加 数据 库 版 本 号 并 发 布 新 的 版 本 ， 将 会 执行 数据 库 升 级 。 下 面 是 一 个 使 用 SQLiteOpenHelper 类 操作 数据 库 的 简单 示例 : 


class SQLiteHelperClass 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public static final int VERSION NUMBER = 1; 

sqlHelper = new SQLiteOpenHelper (context, "ContactDatabase", null, VERSION_NUMBER) { 

@Override 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 

// 删除 表格 

db.execSQL("DROP TABLE IF EXISTS "+ TABLE CONTACTS) ; 

// 重新 创建 表格 

onCreate (db) ; 

} 


GOverride 

public void onCreate (SQLiteDatabase db) { 

// 创建 表格 

String createContactsTable ="CREATE TABLE "+ TABLE CONTACTS + "("+ KEY ID + " INTEGER PRIMARY KEY, "+ KEY NAME + " TEXT, "+ KEY NUMBER + " INTEGER" + ")"; 
try { 


db.execSQL (createContactsTable) ; 
} catch (SQLException e) { 
e.printStackTrace () ; 
} 
} 
GOverride 
public synchronized void close() { 
super.close(); 
Log.d("TAG", "Database closed"); 


GOverride 
public void onOpen(SQLiteDatabase db) { 
super .onOpen (db) ; 
Log.d("TAG", "Database opened"); 
} 
1; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
// 以 只 读 方式 打开 数据 库 
SQLiteDatabase db = SQLiteOpenHelper.getWritableDatabase () ; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
// 以 读 写 方式 打开 数据 库 
SQLiteDatabase db = SQLiteOpenHelper.getWritableDatabase () ; 


3.1.5 SQLiteDatabase 类 


通过 以 上 内 容 的 介绍 ， 读 者 对 利用 SQLiteOpenHelper 类 操作 数据 有 了 一 个 较为 清晰 的 认识 ， 接 下 来 将 介绍 核心 类 SQLiteDatabase。SQLiteDatabase 是 在 Android 中 操作 SQLite 数 据 库 所 要 求 的 最 基 
本 的 类 ， 包 括 的 主要 操作 有 打开 、 查 询 、 升 级 和 关闭 数据 库 。 


SQLiteDatabase 类 包括 50 多 个 方法 ， 每 一 个 方法 都 有 自己 的 语义 和 使 用 方法 。 下 面 列 出 最 常用 和 最 重要 的 方法 : 


= 


ublic long insert(String table, String nullColumnHack, ContentValues values) 


ublic Cursor query(String table, String{Jcolumns, String selection, String[|selectionArgs, String groupBy, String having, String orderBy) 


ublic Cursor rawQuery(String sql, String[]selectionArgs) 


ublic int delete(String table, String whereClause, String[]whereArgs) 


= 


ublic int update(String table, ContentValues values, String whereClause, String[]whereArgs) 


在 下 面 的 例子 中 ， 向 数据 库 表 中 插入 名 称 和 数字 ， 以 便利 用 查询 语句 从 表 中 提取 数据 。 之 后 ， 通 过 delete0 和 update() 方 法 以 ID 作为 参数 标识 要 删除 或 更 新 的 数据 。 


public void insertToSimpleDataBase () 
{ 

SQLiteDatabase db = sqlHelper.getWritableDatabase () ; 

ContentValues cv = new ContentValues(); 

cv.put(KEY NAME, "John"); 

cv.put(KEY NUMBER, "0000000000"); 

// 利用 ContentValues 对 象 向 表 中 插入 不 同 列 

db.insert (TABLE CONTACTS, null, cv); 

cv = new ContentValues () ; 

cv.put(KEY NAME, "Tom"); 

cv.put(KEY NUMBER, "5555555"); 

// 利用 ContentValues 对 象 向 表 中 插入 不 同 列 

db.insert (TABLE CONTACTS, null, cv); 
} http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public void getDataFromDatabase () Е 
1 

int count; 

db = sqlHelper.getReadableDatabase () ; 

// 使 用 查询 语句 提取 数据 

Cursor cr = db. query(TABLE CONTACTS, null, null, null, null, null, null); 

if(cr != null) { 

count = cr.getCount (); 
Log.d("DATABASE", "count is : " + count); 


l 
// 使 用 查询 语句 提取 数据 
cr = db.rawQuery("select * from " + TABLE CONTACTS, null); 
if(cr != null) í ~ 
count = cr.getCount (); 
Log.d("DATABASE", "count is : " + count); 


] 
} http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public void delete (String name) 
{ 

String whereClause = KEY_NAME + "="; 

String[] whereArgs = new String[] {name}; 

db = sqlHelper.getWritableDatabase () ; 

int rowsDeleted = db.delete (TABLE CONTACTS, whereClause, whereArgs) ; 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
public void update (String name) 
{ 

String whereClause = KEY NAME + "="; 

String[] whereArgs new String[] {name}; 

ContentValues cv = new ContentValues(); 


cv.put (KEY NAME, "Betty"); 

cv.put (KEY NUMBER, 999000") ; 

db = sqlHelper.getWritableDatabase () ; 

int rowsUpdated = db.update (TABLE CONTACTS, cv, whereClause, whereArgs) ; 
} 


ContentValues 本 质 上 就 是 键 - 值 对 的 集合 ， 其 中 ， 键 代表 表 的 列 ， 值 代表 向 表格 插入 的 数值 。 例 如 ，values.put("COL_1"，1) 的 情况 ， 表 示 在 列 COL _1 中 插入 值 1。 向 数据 库 表 中 插入 “姓名 ”和 “ 数 
”字段 代码 如 下 : 


Nr 


ContentValues cv = new ContentValues(); 
cv.put(COL NAME, "john doe"); 

cv.put(COL NUMBER, "12345000"); 
dataBase.insert(TABLE CONTACTS, null, cv); 


查询 产生 游标 对 象 。 游 标 对 象 代表 了 查询 结果 ， 基 本 上 是 指向 查询 结果 集 的 一 行 数据 。 可 以 利用 getCount() 方 法 ， 获 得 查询 结果 集中 的 元 素 个 数 。 为 了 访问 结果 集中 的 某 个 数据 行 ， 可 以 使 
moveToFirst0 和 moveToNext( 方 法 。isAfterLast( 方 法 可 以 帮助 用 户 判 断 当 前 指针 是 否 已 指向 最 后 一 条 数据 行 。 


游标 对 象 提供 了 一 系列 访问 数据 元 素 的 方法 ， 这 些 方法 具有 类 似 的 形式 : get*(0。 例 如 getLong(columnlndex) 方 法 和 getstring(columnlndex) 方 法 可 以 从 一 行 数据 中 抽取 对 应 列 数据 ，columnlndex 
是 将 要 访问 列 索引 。 游 标 对 象 也 提供 一 个 通过 表 列 名 查询 列 索引 的 方法 ，getColumnlndexOrThrow(String)。 利 用 这 些 接口 ， 用 户 可 以 随机 读 写 访问 结果 集 。 查 询 结果 的 游标 指针 指向 第 0 个 位 置 ， 该 位 置 
存放 结果 集中 的 第 一 条 记录 。 


3.2 SQLite 连 接 


在 之 前 的 章节 里 ， 为 了 使 用 SQLite 数 据 库 ， 了 解 到 两 个 重要 的 Android 类 和 对 应 的 方法 一 一 SQLiteopenHelper 类 和 SQLiteDatabase 类 。 接 下 来 利用 已 掌握 的 概念 去 实现 Android 应 用 程序 ， 将 更 深入 


也 学 习 如 何 通过 SQL 语句 实现 对 数据 库 的 插入 、 查 询 及 删除 数据 等 操作 。 


为 了 演示 代码 效果 ， 我 们 建立 并 且 运 行 一 个 Android 模 拟 器 ， 以 便 能 在 它 上 面 运行 Android 应 用 程序 。 同 时 将 建立 属于 自己 的 成 熟 数据 库 一 一 contacts。Android 提 供 的 用 户 功 能 强大 的 接口 组 件 有 利于 
户 开发 出 符合 规范 的 、 用 户 界面 友好 的 应 用 程序 ， 这 些 组 件 有 按钮 和 列表 视图 等 。 


321 开始 构建 


Android 是 一 种 可 以 运行 在 硬件 或 软件 差异 较 大 的 设备 上 的 操作 系统 。 运 行 Android 系 统 的 设备 能 够 适应 各 种 各 样 的 硬件 设备 的 变化 。 系 统 自身 携带 一 个 模拟 器 ， 它 可 以 模仿 具有 不 同 特点 的 硬件 设备 。 
可 以 避免 一 些 由 于 CPU 处 理 器 、RAM 或 相机 的 不 同 带 来 的 问题 ， 或 由 系统 不 同 版 本 (从 Cupcake 到 Kitkat) 带 来 的 差异 。 


为 了 能 够 测试 和 运行 开发 的 SQLite 应 用 程序 ， 在 最 流行 的 Android 集 成 开发 环境 Eclipse 中 建立 和 配置 Android 模 拟 器 是 非常 必要 的 。 设 定 模拟 器 步骤 如 下 : 


1) 从 Window 菜 单 中 的 Android Virtual Device Manager 启 动 模 拟 器 。 可 以 设 定 不 同 的 硬件 参数 例如 CPU 型 号 、 前 后 摄像 头 。 


2) 当 启 动 应 用 程序 时 ， 要 保存 到 快照 ， 下 次 启动 来 自 快照 中 的 模拟 器 实例 时 ， 将 会 减少 启动 时 间 。 


3) 创建 一 个 新 的 项 目 一 一 PersonalContactManager。 依 次 选择 File|New|Project， 选 择 Android 中 的 Android Application Project。 完 成 后 ， 将 会 在 工程 中 产生 一 个 Activity 文 件 和 一 个 对 应 的 XML 
文件 。 


创建 一 个 数据 库 一 contact， 该 数据 库 包含 一 个 表 一 ContactsTable。 在 之 前 的 章节 里 介绍 了 怎样 用 SQL 语 句 创建 一 个 数据 库 。 通 过 创建 一 个 数据 库 方案 来 创建 一 个 数据 库 ， 这 一 步 是 基于 应 用 程序 
的 需求 。 建 立 一 个 个 人 的 联系 人 管理 器 ， 表 3-3 中 包含 的 字段 有 名 字 (Name) 、 编 号 (Number) 、 邮 箱 (Email) . RH (Photo) 。 


表 3-3 个 人 的 联系 人 管理 器 


Column DataType 
Contact ID Integer/primary key/autoincrement 
Name Text 
Number Text 
Email Text 
Photo Blob 


一 个 Android 应 用 程序 可 以 包含 多 个 数据 库 ， 每 个 数据 库 中 也 可 以 包含 多 个 数据 表 。 每 一 个 表 都 以 二 维 的 形式 储存 数据 ( 行 和 列 ) 。 


第 一 列 是 Contact-ID。 它 的 数据 类 型 是 整数 ， 列 约束 是 主键 ， 并 且 数 据 值 是 自动 增加 的 ， 这 意味 着 随 着 数据 的 插入 ， 该 列 的 数据 值 会 在 前 一 行 的 基础 上 自动 增加 。 


主键 可 以 识别 每 一 行 并 且 不 能 为 空 。 数 据 库 中 的 每 一 个 表 都 有 一 个 主键 。 每 一 个 表 的 主键 可 以 作为 另 一 表 的 外 键 。 外 键 可 以 连接 两 个 相关 的 表格 。 为 了 说 明 外 键 如 何 连接 两 个 表格 ， 假 设 存在 如 下 两 个 
表格 : 


ContactsTable (contact-ID, Name, Email, Photo) 
ColleagueTable (Colleague-ID, Contact-ID, Position, Fax) 


ContactsTable 表 的 主键 Contact-1D 可 以 作为 ColleagueTable 表 的 外 键 。 


在 表 中 约束 条 件 就 是 对 数据 处 理 的 一 些 规则 ， 这 能 确保 数据 库 中 数据 的 准确 性 和 可 靠 性 。 与 其 他 的 SQL 数据 库 不 一 样 ，SQLite 并 不 严格 限制 插入 列 中 数据 的 类 型 。 当 实际 插入 的 数据 类 型 与 表 中 列 定义 
的 数据 类 型 不 一 致 时 ，SQLite 会 自动 进行 类 型 转换 。 


可 以 针对 表格 或 表 列 定义 约束 。 列 级 约束 只 能 应 用 一 列 ， 而 表 级 约束 应 用 于 整个 表 。 以 下 是 SQLite 中 常用 的 约束 和 关键 词 : 


“ 非 空 约束 : 确保 该 列 数据 中 没有 空 数据 值 。 


ЛЖ: 用 户 为 指定 数值 的 列 提 供 一 个 默认 值 。 

“ 唯一 性 的 约束 : 这 可 以 确保 一 个 列 中 的 所 有 值 都 是 不 同 的 。 
“主键 ; 在 一 个 数据 库 表 中 唯一 地 标识 所 有 行 /记录 。 

“ 检查 约束 : 检查 约束 确保 所 有 列 的 值 满足 某 些 条 件 。 


“ 自动 增加 关键 字 : 自动 增 量 可 以 保证 表格 中 一 列 自动 增加 。 只 可 以 在 数据 类 型 的 列 上 使 用 关键 字 自 动 增加 关键 字 。 


接 下 来 使 用 数据 库 方案 生产 数据 模型 类 。 其 中 ，ContactModel 类 的 成 员 包括 : Contact ID、name、contactNo、Email 和 Photo， 分 别 表 示 id、 名 称 、 联 系 号 、 电 子 邮 件 和 图 片 。 类 将 为 每 一 个 数据 
设置 一 对 setter/getter 方 法 来 设置 和 获取 属性 值 。 使 用 数据 模型 将 促进 数据 程序 处 理 与 数据 库 处 理 程序 之 间 的 数据 通信 。 创 建 一 个 新 包 和 一 个 新 类 一 一 ContactModel 类 。 这 个 类 的 描述 如 下 : 


public class ContactModel { 
private int id; 
private String name, contactNo, email; 
private byte[] byteArray; 
public byte[] getPhoto() { 
return byteArray; 


} 
public void setPhoto(byte[] array) { 
byteArray = array; 


} 

public int getId() { 
return id; 

} 

public void setId(int id) { 
this.id = id; 
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通过 建立 包含 查询 、 更 新 和 删除 数据 方法 的 支持 类 ， 可 以 满足 用 户 利用 该 类 实现 对 数据 库 表 查询 、 更 新 和 删除 数据 的 需求 。 这 个 类 能 够 创建 和 更 新 数据 库 ， 并 作为 数据 管理 中 心 。 使 用 这 个 类 来 运行 
SQLite 查 询 和 发 送 数据 到 Ul。 


public class DatabaseManager { 
private SQLiteDatabase db; 
private static final String DB NAME = "contact"; 
private static final int DB VERSION - 1; 
private static final String TABLE NAME = "contact table"; 
private static final String TABLE ROW ID = " id"; 
private static final String TABLE ROW NAME = "contact name"; 
private static final String TABLE ROW PHONENUM = "contact number"; 
private static final String TABLE ROW EMAIL = "contact email"; 
private static final String TABLE ROW PHOTOID - "photo id"; 
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首先 创建 一 个 SQLiteDatabase 类 的 对 象 ， 随 后 利用 getWriteableDatabase() 或 者 getReadable-Database() 初 始 化 。 


3.2.2 ”数据 库 基本 操作 


1. 创 建 操作 


通过 建立 并 执行 查询 语句 ， 可 以 获取 表 中 期 望 列 的 数据 。 该 语言 将 会 包含 表 名 称 、 不 同 表 列 和 对 应 的 数据 类 型 。 


private class CustomSQLiteOpenHelper extends SQLiteOpenHelper { 
public CustomSQLiteOpenHelper (Context context) { 
super (context, DB NAME, null, DB VERSION); 


GOverride 

public void onCreate (SQLiteDatabase db) { 
String newTableQueryString - "create table " 
+ TABLE NAME + " (" 

TABLE ROW ID 

" integer primary key autoincrement not null," 
TABLE ROW NAME 

" text not null," 

TABLE ROW PHONENUM 

" text not null," 

TABLE ROW EMAIL 

" text not null," 

TABLE ROW PHOTOID 

" BLOB" + ");"; 

db.execSQL (newTableQueryString); 

} 

GOverride 

public void onUpgrade (SQLiteDatabase db, int oldVersion, 
int newVersion) ( 

String DROP TABLE = "DROP TABLE IF EXISTS " + 
TABLE NAME; 

db.execSQL(DROP TABLE); 

onCreate (db) ; 

} 

} 


十 十 十 十 十 十 十 十 十 十 


CustomSQLiteOpenHelper 继 承 了 SQLiteOpenHelper 类 ， 为 用 户 提供 了 关键 的 onCreate() 和 onUpgrage() 方 法 。 将 该 类 作为 DatabaseManager 类 的 内 部 类 ， 便 于 管理 所 有 与 数据 库 相 关 的 函数 ， 即 
CRUD (创建 、 查 询 、 更 新 和 删除 ) 。 


CustomSQLiteOpenHelper 的 构造 函数 负责 创建 类 的 实例 。 在 该 构造 函数 中 ， 传 递 一 个 上 下 文 环境 ， 随 后 将 被 传递 给 父 类 的 构造 函数 ， 参 数 有 : 
+ Context context: 传递 给 构造 函数 的 上 下 文 。 

- Sting name: 数据 库 名 称 。 

+ CursorFactory factory: 游标 工厂 对 象 ， 这 里 设置 为 null。 


+ int version: 数据 库 版 本 。 


下 面 的 代码 创建 了 一 个 SQLite 查 询 字 符 串 ， 利 用 该 字符 串 可 以 创建 数据 库 表 。 创 建 过 程 在 方法 onCreate() 中 。 


"create table " + TABLE NAME + " ("+ TABLE ROW ID 

+ " integer primary key autoincrement not null," 
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关键 字 create table 被 用 来 创建 数据 表 。 关 键 字 后 跟 上 表 名 称 、 列 声明 和 它们 的 数据 类 型 。 在 编写 好 SQL 语句 后 ， 利 用 SQLite 数 据 库 中 的 execSQL() 方 法 执行 该 SQL 语句 。 默 认 情况 下 ， 在 分 配给 该 应 
程序 的 内 部 内 存 空间 中 建立 数据 库 。 可 以 在 如 下 的 文件 夹 中 找到 : 


/data/data/«&,£ »/databases/ 


可 以 很 容易 地 验证 数据 库 是 否 产生 ， 在 模拟 器 或 手机 中 运行 这 段 代码 ， 利 用 开发 工具 Eclipse， 切 换 到 DDM SS 透视 图 ， 通 过 文件 管理 器 可 以 轻松 地 导航 到 指定 的 文件 夹 。 该 操作 需要 足够 的 权限 。 也 可 以 
在 文件 浏览 器 的 帮助 下 ， 查 找到 对 应 的 数据 库 ， 利 用 另外 一 个 独立 的 SQLite 管 理 器 工具 ， 查 看 数据 库 和 执行 CRUD 操 作 。 


2. 插 入 操作 


插入 一 行 新 数据 到 数据 库 表 中 ， 可 以 使 用 insert() 方 法 或 者 创建 一 个 插入 语句 ， 然 后 执行 execute() 方 法 : 


public void addRow(ContactModel contactObj) { 
ContentValues values = prepareData (contactObj); 
try { 
db.insert (TABLE NAME, null, values); 
} catch (Exception e) { 
Log.e("DB ERROR", e.toString()); 
e.printStackTrace(); 
} 


如 果 表 名 称 是 错误 的 ，SQLite 通 过 log 工 具 给 出 无 此 表 的 提示 信息 并 显示 一 个 android.database.sqlite.SQLiteException 异 常 。 利 用 方法 addRow() 可 以 向 数据 库 中 插入 一 行 数 据 ， 该 方法 的 参数 是 
ContactModel 类 的 对 象 。 通 过 另外 一 个 附件 的 prepareData() 方 法 ， 借 助 ContactModel 对 象 的 getter 方 法 构建 ContentValues 对 象 。 


values.put (TABLE ROW NAME, contactObj.getName ()); 
values.put (TABLE ROW PHONENUM, contactObj.getContactNo()); 


ContentValues 对 象 的 准备 工作 完成 后 ， 使 用 SQLiteDatabases 类 提供 的 方法 insert() 向 数据 库 中 插入 数据 。 


public long insert (String table, String nullColumnHack, ContentValues values) 


插入 方法 的 参数 包括 : 
Жж: 待 插入 行 数据 的 数据 库 表 。 
“ 值 : 为 插入 表 行 而 准备 的 包含 初始 列 值 的 键 - 值 对 。 键 为 列 名 称 ， 值 为 向 数据 库 插入 的 数值 。 


+ nullColumnHack: 当 values 参 数 为 空 或 者 里 面 没有 内 容 时 ，insert 会 失败 (底层 数据 库 不 允许 播 入 一 个 空 行 ) ， 为 了 防止 这 种 情况 ， 要 在 这 里 指定 一 个 列 名 ， 到 时 候 如 果 发 现 将 要 插入 的 行为 空 行 时 ， 就 
会 将 指定 的 这 个 列 名 的 值 设 为 nall， 然 后 再 向 数据 库 中 插入 。 


不 通过 insert() 方 法 插入 数据 ， 而 是 利用 准备 的 SQL 语句 并 执行 该 语句 的 方式 具体 代码 如 下 : 


public void addRowAlternative (ContactModel contactObj) { 
String insertStatment = "INSERT INTO " + TABLE NAME 


+ 


TABLE ROW NAME 4 "," 
TABLE ROW PHONENUM + "," 


TABLE ROW EMAIL + "," 
TABLE ROW PHOTOID 


non = 


++++++ 


" VALUES " 

十 " (rrr) т 
SQLiteStatement s = db.compileStatement (insertStatment) 7 
s.bindString(1, contactObj.getName()); 
s.bindString(2, contactObj.getContactNo()); 
s.bindString(3, contactObj.getEmail()); 
if (contactObj.getPhoto() != null) { 

s.bindBlob(4, contactObj.getPhoto()); 


s.execute () ; 


) 


getRowAsObject() 方 法 将 会 以 ContactModel 对 象 的 方式 返回 从 数据 库 中 查询 的 结果 。 该 方法 在 提取 数据 表 中 数据 时 ， 利 用 了 表示 行 的 唯一 标识 符 rowlD。 


public ContactModel getRowAsObject (int rowID) { 
ContactModel rowContactObj = new ContactModel (); 
Cursor cursor; 
try { 
cursor = db.query(TABLE NAME, new String[] { 
TABLE ROW ID, TABLE ROW NAME, TABLE ROW PHONENUM, TABLE ROW EMAIL, 
TABLE ROW PHOTOID }, 
TABLE ROW ID + "=" + rowID, null, 
null, null, null, null); 
cursor.moveToFirst () ; 
if (!cursor.isAfterLast()) { 
prepareSendObject (rowContactObj, cursor); 


} catch (SQLException e) ( 
Log.e("DB ERROR", e.toString()); 
e.printStackTrace (); 

$ 


return rowContactObj; 


这 个 方法 将 返回 从 数据 库 以 ContactModel 对 象 的 形式 获取 的 行 数据 。 


public Cursor query (String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit) 


下 面 是 上 述 代码 的 参数 : 


stable: 表示 将 要 查询 的 数据 库 表 。 


* columns: 表示 需要 查询 数据 列 列表 ; 如 果 参 数 为 null， 返 回 所 有 列 。 


+ selection: 作为 SQL 语句 的 WHERE 子 名 定义 需要 返回 的 行 ; 如 果 参 数 为 nnll， 返 回 所 有 行 。 


+ selectionArgs: 该 参数 可 以 为 null; 或 者 用 它 的 数值 替换 selection 中 的 问号 。 

“ groupBy: 这 是 一 个 过 滤器 框架 ， 作 为 一 个 SQL 的 GROUP BY 子 句 ， 声 明 如 何 对 行 分 组 。 

+ Having: 这 是 一 个 过 滤器 ， 告 诉 哪些 行 作 为 游标 的 一 部 分 。 传 递 null 会 导致 所 有 行 都 包括 在 内 。 
+ OrderBy: 利用 ORDER BY 子 名 告诉 查询 如 何 排序 结果 集 。 传 递 null 将 使 用 默认 的 排序 顺序 。 


+ Limit: 利用 Limit 子 句 可 以 限制 查询 返回 查询 结果 集 的 行 数 。 传 递 null 代 表 没有 限制 。 


另 一 个 重要 的 概念 是 移动 游标 访问 数据 ， 方 法 包括 : cursor.moveToFirst(, cursor.isAterLast()&cursor.moveToNext(), 


当 试 图 检索 时 ， 将 首先 创建 数据 库 游标 对 象 并 返回 其 对 象 引 用 。 这 返回 的 引用 指针 指向 第 0 位 置 ， 这 也 被 称 为 游标 “第 一 位 置 之 前 ”。 当 想 要 检索 数据 时 ， 必 须 首 先 转移 到 第 一 个 记录 ， 此 时 需 使 
cursor.moveToFirst()。 其 他 的 两 种 方法 ，cursor.isAfterLast() 返 回 的 指针 指向 最 后 一 行 记录 之 后 ; cursor.moveToNext() 将 游标 移动 到 下 一 行 。 另 外 ， 可 以 使 用 下 面 的 方法 : 


public ContactModel getRowAsObjectAlternative (int rowID) { 

ContactModel rowContactObj = new ContactModel (); 

Cursor cursor; 

try { 
String queryStatement = "SELECT * FROM " 
+ TABLE NAME + " WHERE " + TABLE ROW ID + "="; 
cursor = db.rawQuery (queryStatement, — 
new String[](String.valueOf (rowID)]); 
cursor.moveToFirst () ; 
rowContactObj = new ContactModel (); 
rowContactObj.setId(cursor.getInt (0) ) 7 
prepareSendObject (rowContactObj, cursor); 

} catch (SQLException e) { 
Log.e("DB ERROR", e.toString()); 
e.printStackTrace () ; 

š 

return rowContactObj; 


} 


在 讨论 datamanager 类 中 的 其 他 方法 之 前 ， 先 了 解 如 何 利用 prepareSendObject() 方 法 从 游标 对 象 中 获取 数据 : 


rowObj.setContactNo (cursor.getString (cursor.getColumnIndexOrThrow (TABLE ROW PHONENUM))); 
rowObj.setEmail(cursor.getString (cursor.getColumnIndexOrThrow (TABLE ROW EMAIL))); 


这 里 cursor.getstring() 的 列 索 引 作 为 参数 并 返回 请 求 的 列 的 值 ， 而 cursor.getColumn-lndexOrThrow() 需 要 的 列 名 字 作为 参数 ， 并 返回 给 定 的 列 名 称 的 从 零 开始 的 索引 。 如 果 不 是 这 种 链 方法 ， 可 以 直 
接 使 用 cursor.getstring()。 如 果 知 道 提取 数据 列 的 列 号 ， 可 以 使 用 下 面 的 符号 : 


cursor.getstring (2); 


3. 删 除 操作 


为 了 从 数据 库 表 中 删除 某 一 行 数据 ， 在 删除 时 只 要 提供 能 唯一 标识 数据 集中 待 删除 的 数据 行 标识 符 即 可 


public void deleteRow(int rowID) { 
try { 
db.delete (TABLE NAME, TABLE ROW Ір+ "=" + rowID, null); 
} catch (Exception e) { zii d 
Log.e("DB ERROR", e.toString()); 
e.printStackTrace () ; 


该 方法 利用 SQLiteDatabase 类 中 delete() 方 法 删除 表 中 指定 ID 的 数据 行 : 


public int delete (String table, String whereClause, String[] whereArgs) 


上 述 代 码 中 的 参数 列表 为 : 
stable: 查询 中 待 访 问 数据 库 表 。 
- whereClause: 删除 行使 用 的 子 句 ; 如 果 参 数 为 nall， 删 除 所 有 的 行 数 据 。 


-whereArgs: 使 用 该 参数 替代 where 子 名 中 的 问号 。 


也 可 以 使 用 如 下 的 方式 实现 相同 的 功能 : 


public void deleteRowAlternative(int rowId) { 

String deleteStatement = "DELETE FROM "+ TABLE NAME + " WHERE "+ TABLE ROW ID + "="; 
SQLiteStatement s = db.compileStatement (deleteStatement) ; 

s.bindLong(1, rowId); 

s.executeUpdateDelete () ; 

} 


4. 更 新 操作 


为 了 更 新 已 存在 的 数据 ， 利 用 要 求 的 参数 调用 update() 方 法 完成 相应 的 工作 。 


public void updateRow(int rowId, ContactModel contactObj) { 
ContentValues values = prepareData (contactObj); 
String whereClause = TABLE ROW ID + "="; 
String whereArgs[] = new String[] (String.valueOf (rowId) } 7 
db.update(TABLE NAME, values, whereClause, whereArgs); 

} 


本 例 中 的 rowld 参 数 可 以 确定 将 要 被 修改 的 行 。SQLiteDatabase 类 中 的 update() 方 法 用 于 修改 数据 库 表 中 已 经 存在 数据 : 


public int update (String table, ContentValues values, String whereClause,String[] whereArgs) 


以 下 是 之 前 的 代码 中 的 参数 : 

- table: 查询 中 待 访 问 数据 库 表 。 

values: 表示 从 列 名 到 新 的 列 值 的 映射 。 

+ whereClause: 删除 行使 用 的 子 句 ; 如 果 参 数 为 null， 删 除 所 有 的 行 数据 。 


-whereArgs: 使 用 该 参数 普 代 where 子 和 句 中 的 问号 。 


也 可 以 使 用 如 下 的 代码 完成 相同 的 功能 : 


public void updateRowAlternative (int rowId, ContactModel contactObj) { 
String updateStatement = "UPDATE " + TABLE NAME + " SET " 

+ TABLE ROW NAME + "=," 

+ TABLE ROW PHONENUM + " 


+ TABLE ROW PHOTOID + "= 
+ " WHERE " + TABLE ROW ID + "="; 
SQLiteStatement s = db.compileStatement (updateStatement) ; 
s.bindString(1, contactObj.getName () ) 7 
s.bindString(2, contactObj.getContactNo()); 
s.bindString(3, contactObj.getEmail()); 
if (contactObj.getPhoto() != null)( 
s.bindBlob(4, contactObj.getPhoto()); 
} 
s.bindLong(5, rowId); 
s.executeUpdateDelete () ; 
} 


3.2.3 ”数据 库 与 Ul 连接 


为 了 便于 用 户 操 作 数 据 库 ， 将 数据 库 与 Ul 连接 起 来 是 非常 必要 的 ， 具体 步骤 如 下 : 


1) 从 用 户 获取 数据 。 可 以 借助 于 content provider 组 件 从 Android 的 contact 应 用 程序 中 提取 数据 。 


2) 使 用 的 是 标准 的 Android UI 小 控件 ， 如 EditText、TextView 以 及 Buttons 来 表示 从 用 户 处 获取 的 数据 。 


private void prepareSendData() { 


if (TextUtils.isEmpty (contactName.getText ().toString()) || TextUtils.isEmpty (contactPhone.getText().toString())) { 
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) else ( 


ContactModel contact = new ContactModel(); 
contact.setName (contactName.getText ().toString()); 
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DatabaseManager dm = new DatabaseManager (this); 
if(reqType == ContactsMainActivity 
.CONTACT UPDATE REQ CODE) { 
dm.updateRowAlternative (rowId, contact); 

) else ( 
dm.addRowAlternative (contact); 

} 

setResult (RESULT OK); 

finish (); = 

} 


Ш 


7&ргерагеЅепараќа() #819359, ПЕЛА ЕЛЕН, {ЕЗЕН ЖЕНЕН, HA McontactName+-RIEASHANKEME, mufsBFHTextUtils.isEmpty073;A, MRF 
是 空 或 者 长 度 为 零 返回 true。 


3) 接受 用 户 从 表单 中 填 入 的 数据 生成 ContactModel 对 象 ， 创 建 一 个 DatabaseManager 类 的 实例 ， 访 问 addRow() 方 法 ， 传 递 待 插入 数据 库 的 contact 对 象 。 另 一 个 重要 的 方法 是 getBlob0， 利 用 该 方 
法 可 以 获取 以 BLOB 格 式 保 存 的 图 片 数 据 。 


private byte[] getBlob() { 
ByteArrayOutputStream blob = new ByteArrayOutputStream () ; 
imageBitmap.compress (Bitmap.CompressFormat.JPEG, 100, blob); 
byte[] byteArray = blob.toByteArray () 7 
return byteArray; 


Д) 创建 一 个 新 的 ByteArrayOutputStream 对 象 blob。 利 用 位 图 的 compress() 方 法 将 压缩 后 的 位 图 写 入 outputstream 对 象 中 : 


D 


public boolean compress (Bitmap.CompressFormat format, int quality, OutputStream stream) 


上 述 代码 中 参数 如 下 : 


- format: 压缩 图 像 的 格式 ， 如 JPEG。 


‘quality: 表示 编码 器 的 性 能 ， 范 围 从 0 到 100， 数 值 0 意 味 着 压缩 后 文件 更 小 ， 图 像 质量 更 差 ， 而 数值 100 表 示 最 好 的 质量 。 


+ теат: 是 写 压缩 数据 的 输出 流 。 


5) 创建 byte[] 对 象 ， 是 由 ByteArrayOutputStream 类 中 toByteArray() 方 法 产生 的 。 


Customer 布 局 视图 列表 。 注 意 在 以 下 构造 函数 初始 化 一 个 新 的 数组 列表 ， 并 将 通过 使 用 getAllData() 


6) 做 一 个 定制 的 列表 视图 类 ， 自 定义 一 个 CustomListAdapter 类 ， 它 继承 于 BaseAdapter, 使 
方法 ， 借 助 于 数据 库 管理 器 获取 数据 库 数据 : 


public CustomListAdapter (Context context) { 
contactModelList = new ArrayList<ContactModel>(); 
context = context; 
inflater = (LayoutInflater) context .getSystemService ( 
Context .LAYOUT INF1ATER SERVICE); 
dm = new DatabaseManager( context); 
contactModelList = dm.getAllData(); 


另 一 个 非常 重要 的 方法 是 getView() 方 法 。 


convertView = inflater.inflate(R.layout.contact list row, null); 
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使 用 视 | 


持 有 人 模式 改善 列表 视图 滚动 平滑 度 : 


vHolder = (ViewHolder) convertView.getTag(); 


7) 最 后 ， 设 置 数据 到 对 应 的 视图 中 : 


vHolder.contact email.setText (contactObj.getEmail()); 


8) 为 了 实现 从 列表 视图 中 删除 数据 的 功能 ， 使 用 上 下 文 菜单 可 以 比较 方便 地 完成 。 在 工程 目录 下 的 res 目 录 中 的 menu 文 件 夹 中 创建 菜单 项 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«menu xmlns:android-"http:// schemas.android.com/apk/res/android" > 
«item 
android: id="@+id/delete_item" 
android:title="Delete"/> 
<item 
android: id="@+id/update_ item" 
android: title="Update"/> 
</menu> 


9) 在 主 活动 中 将 显示 列表 视 


， 使 用 下 面 的 方法 为 列表 视图 注册 上 下 文 菜单 。 为 了 启动 上 下 文 菜单 ， 需 要 执行 一 个 长 按 列表 视图 项 的 动作 : 


0 


registerForContextMenu (listReminder) 


10) 为 了 能 够 完成 删除 功能 ， 还 需要 实现 一 些 其 他 的 方法 : 


GOverride 

public void onCreateContextMenu (ContextMenu menu, View v, ContextMenuInfo menuInfo) { 
super.onCreateContextMenu (menu, v, menuInfo); 
MenuInflater m = getMenuInflater(); 
m.inflate(R.menu.del menu, menu); 


} 


该 方法 利用 前 面 定义 的 XML 产生 上 下 文 菜单 。 类 Menulnflater 从 菜单 XML 文件 生成 菜单 对 象 。 


11) 实现 一 个 方法 来 捕捉 单 击 上 下 文 菜单 。 


GOverride 

public boolean onContextItemSelected (MenuItem item) ( 

http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/ . . http: / /www .hzcourse.com/resource/readBook?path-/openresources/teach 
case R.id.delete item: 7 
cAdapter.delRow (info.position) ; 

cAdapter.notifyDataSetChanged () ; 

return true; 

case R.id.update item: 

Intent intent - new Intent (ContactsMainActivity.this, AddNewContactActivity.class); 

http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text./ . . http: / /www.hzcourse.com/resource/readBook?path-/openresources/teach | 


12) 通过 找到 被 单 击 的 列表 视图 中 的 项 目的 位 置 ID， 调 用 CustomListAdapter 中 delRow() 方 法 ， 随 后 通知 适配器 数据 集 已 经 更 改 : 


public void delRow(int delPosition) { 
dm.deleteRowAlternative (contactModelList.get (delPosition) .getId()); 
contactModelList . remove (delPosition) ; 


delRow() 方 法 负责 将 数据 库 的 deleteRowAlternative() 方 法 与 上 下 文 菜单 的 delete() 方 法 联系 起 来 。 获 取 对 象 上 设置 特定 的 ID 列表 视图 项 并 将 其 传递 给 databaseManager 类 的 deleteRowAlternative() 
方法 ， 删 除数 据 库 中 的 数据 。 从 数据 库 中 删除 数据 后 ， 将 从 联系 人 列表 视图 删除 相应 的 条 目 。 


33 数据 共享 


Content Provider 是 Android 应 用 的 第 四 个 组 件 。 它 用 来 管理 访问 结构 性 数据 集 。Content Provider 能 够 封装 数据 ， 并 且 提供 数据 抽象 和 定义 数据 安全 的 机 制 。 然 而 ，Content Provider 主 要 目的 在 于 
让 其 他 程序 访问 Provider 的 客户 对 象 。 提 供 者 和 提供 者 客户 提供 了 一 个 一 致 的 、 标 准 的 数据 访问 接口 ， 通 过 该 接口 可 以 进行 进程 间 通 信和 安全 数据 访问 。 


D 


ilk 


一 个 应 用 程序 利用 Content Provider 可 以 向 其 他 应 用 程序 分 享 数据 。 一 般 来 说， 应 用 程序 创建 的 Android SQLite 数 据 库 是 私有 的 ， 如 果 从 安全 的 角度 考虑 ， 这 是 非常 成 功 的。 但 是 ， 应 用 程序 试图 共 
其 数据 给 其 他 的 应 用 程序 则 会 带 来 一 系统 的 麻烦 。Content Provider 能 够 解决 上 述 问题 ， 用 户 可 以 通过 建立 Content Provider 来 分 享 数据 。 其 实 讨论 聚焦 在 利用 Content Provider 访 问 数据 库 ， 实 际 上 
Content Provider 并 不 仅仅 局 限于 此 。 它 也 可 被 用 来 为 文件 数据 提供 共享 机 制 ， 如 : 照片 、 音 频 和 视频 。 


进程 A 进程 B 


应 用 程序 A | 应 用 程序 B 


Content Provlder 


Content Resolver PSs 


Methodl() 
Method2() 


Methodn() 


Methodl() 
Method2() 


Methodn() 


进程 内 通信 


图 3-3 ”进程 内 通信 


在 前 面 的 图 3-3 中 ， 显 示 了 应 用 程序 A 和 应 用 程序 B 之 间 数 据 交换 时 的 互动 。 应 用 程序 A 的 活动 需要 访问 应 用 程序 B 的 数据 库 。 应 用 程序 B 的 数据 库 储 存在 内 部 内 存 空间 中 ， 且 应 用 程序 A 是 不 能 直接 访问 。 


这 就 是 Content Provider 出 现在 这 儿 的 原因 ， 它 给 予 用 户 共享 数据 和 访问 其 他 应 用 程序 资源 的 方法 。Content Provider 实 现 了 访问 数据 库 的 查询 、 插 入 、 更 新 和 删除 操作 。 首 先 要 用 Content Provider 从 电 


话 联系 人 数据 库 中 获取 联系 人 信息 ， 然 后 建立 自己 的 Content Provider 便 于 其 他 应 用 程序 获取 数据 库 的 数据 。 


3.3.1 Content Provid 


er 实现 数据 共享 


1. 利 用 已 存在 的 Content Provider 实 现 数据 共享 


Android 列 出 了 许多 能 


的 、 标 准 的 Content Provider， 包 括 Browser、CalendarContract、CallLog、Contacts、ContactsContract、Mediastore、userDictionary 等 。 


在 当前 联系 人 管理 应 


程序 中 ， 随 后 将 加 入 一 个 新 的 特征 。 在 类 AddNewContactActivity 的 用 户 接口 中 ， 将 增加 一 个 小 按钮 ， 在 系统 提供 的 ContentProvider 和 ContentResolver 组 件 的 帮助 下 ， 从 电 


话 联系 人 名 单 中 获取 联系 人 信息 。 


2.ContentResolver 


应 用 程序 上 下 文中 的 ContentResolver 是 一 个 与 ContentProvider 通 信 的 客户 端 。Content-Resolver 对 象 与 ContentProvider 对 象 相互 通信 ，ContentProvider 对 象 是 实现 了 ContentProvider 的 类 的 一 


个 实例 。ContentProvider 对 象 接 受 客户 端的 数据 请 求 ， 执 行 请 求 的 动作 并 返 


结果 。 


回 


ContentResolver 在 应 


程序 中 是 一 个 单一 的 、 全 局 的 实例 ， 为 访问 其 他 应 用 程序 的 ContentProvider 提 供 了 访问 方式 。 不 需要 担心 如 何 处 理 进程 之 间 的 通信 问题 。ContentResolver 提 供 最 基本 的 


CRUD (创建 、 检 索 、 更 新 和 删除 ) 持续 存储 函数 。 


LI PersonalContactManager 


3⁄4 AAA 


注意 右 侧 的 新 
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标 ， 该 图 标 表示 可 以 从 电话 联系 人 中 添加 联系 人 信息 。 修 改 了 现存 的 XML 来 添加 那个 按钮 ， 相 应 的 AddNewContactActivity 类 也 将 被 修改 为 : 


public void pickContact() { 
try { 
Intent cIntent = new Intent (Intent.ACTION PICK, 
ContactsContract.Contacts.CONTENT URI); ~ 
startActivityForResult (cIntent, PICK CONTACT); 
) catch (Exception e) { ni 
e.printStackTrace(); 
Log.i(TAG, "Exception while picking contact"); 
} 
} 


在 此 添加 了 一 个 新 的 方法 pickContact() 准 备 一 个 提取 联系 人 信息 的 Intent。lntent.ACTION_PICK 人 允许 用 户 从 数据 源 中 挑选 一 个 item， 此 外 ， 为 了 成 功 地 访问 数据 ， 还 应 该 知道 Content Privider 的 


Uniform Resource Identifier(URID)， 在 这 儿 是 ContactsContract.Contacts.CONTENT_URI。 下 面 是 为 了 完成 从 Android 的 联系 人 供应 者 中 提取 联系 人 信息 而 添加 的 部 分 代码 。 


[http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/... 
else if (requestCode — PICK CONTACT) ( 
if (resultCode == Activity.RESULT OK) 
{ 
Uri contactData = data.getData(); 
Cursor c = getContentResolver().query(contactData, null, null,null, null); 
if (c.moveToFirst()) ( 
String id = c.getString(c.getColumnIndexOrThrow (ContactsContract.Contacts. ID)); 
String hasPhone - E 
c.getString (c.getColumnIndex (ContactsContract.Contacts.HAS PHONE NUMBER)); 
if (hasPhone.equalsIgnoreCase ("1")) { 
Cursor phones = 


getContentResolver () .query (ContactsContract .CommonDataKinds .Phone.CONTENT_URI, null, ContactsContract .CommonDataKinds.Phone.CONTACT_ID+ " = " + id, null, null); 


phones .moveToFirst (); 

contactPhone.setText (phones. getString (phones. getColumnIndex ("datal"))); 
contactName.setText (phones.getString (phones .getColumnIndex (ContactsContract. 
Contacts.DISPLAY NAME) ) ) ; 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 


通过 交叉 检查 resultcode， 判 断 请 求 码 是 否 与 设 定 的 相符 。 在 Context 对 象 上 调用 getcontentresolver() 方 法 可 以 获得 ContentResolver 对 象 。 该 方法 是 隶属 于 Android 的 android.content.Context 类 。 


3.3.2 ”创建 Content Provider 


1. 创 建 一 个 Content Provider 


一 个 Content Provider 提 供 两 种 访问 数据 的 方式 : 一 个 是 像 数据 库 形式 的 结构 数据 ， 另 外 一 个 是 以 文件 数据 的 形式 ， 就 是 数据 以 图 片 、 音 频 和 视频 等 其 他 的 形式 存储 在 应 用 程序 的 私 用 空间 。 在 讨论 如 


何 创建 一 个 Content Provider 之 前 ， 用 户 要 反复 权衡 是 否 真 的 需要 一 个 Content Provider? 如 果 想 给 其 他 应 用 程序 提供 共享 数据 ， 人 允许 用 户 从 应 用 程序 中 复制 数据 到 另 一 个 应 用 程序 ， 或 使 


应 用 程序 的 搜 


索 框 架 ， 那 么 答案 是 肯定 的 。 


就 像 其 他 Android 组 件 (Activity、Service 或 BroadcastReceiver) ， 创 建 一 个 继承 于 Content-Provider 类 的 新 类 。 因 为 ContentProvider 是 一 个 抽象 类 ， 为 了 能 够 进行 实例 化 ， 必 须 实现 表 3-4 所 示 的 6 


种 抽象 方法 。 


AMA 六 种 抽象 方法 


Method Usage 
Void onCreate() 初始 化 提供 者 
String getType(Uri) 返回 Content Provider 提供 的 数据 MIME 类 型 
Int delete(Uri uri,String selection,String[] selectionArgs) 删除 Content Provider 的 数据 
Uri insert(Uri uri,ContentValues values) 向 Content Provider 中 插入 新 的 数据 


Cursor query(Uri uri, Strin rojection, String selection,Strin : е Lig 
oa oe g[] proj g ell 返回 数据 到 调用 者 
selectionArgs, String sortOrder) 
int update(Uri uri, ContentValues values, String selection, String[] 
selectionArgs) 


更 新 Content Provider 中 已 经 存在 的 数据 


这 些 方法 将 在 后 面 详细 介绍 。 


2.content URI 介 绍 


Content Provider 的 每 一 个 数据 访问 方法 都 有 一 个 内 容 URI， 它 作为 一 个 参数 来 决定 用 户 要 访问 的 表 、 行 或 文件 。 一 般 来 说 有 以 下 结构 : 


content:// authority/path/Id 


通过 分 析 content:WURI 的 各 个 组 成 部 分 可 以 充分 了 解 它 的 作用 和 使 用 方法 。Content Provider 的 工作 方案 总 是 content。 冒 号 和 双 和 斜 杠 则 是 将 content 与 authority 部 分 分 开 。 规 则 上 ，authority 对 于 每 
一 个 Content Provider 必 须 是 独一无二 的 。Android 文 档 建 议 使 用 的 传统 命名 方式 使 用 Content Provider 的 子 类 完全 限定 类 名 。 一 般 来 说 ， 就 是 由 发 布 出 来 的 每 一 个 Content Provider 类 名 加 包 名 构成 。 


剩余 的 部 分 是 可 选 定 项 ， 也 被 称 为 路 径 ， 用 于 隔离 Content Provider 可 以 提供 不 同类 型 之 间 的 数据 。 一 个 最 好 的 例子 就 是 MediaStore 提 供 者 ， 可 以 区 分 音频 、 视 频 和 图 像 文件 。 


另 一 个 可 选 的 部 分 是 id， 指 向 一 个 特定 的 记录 ， 如 果 id 存 在 ， 相 应 的 URI 变 为 基于 1D 的 或 基于 目录 的 URI。 从 另 一 个 角度 理解 它 就 是 一 个 基于 1D 的 URI 能 够 在 数据 行 级 别 进行 交互 ， 而 基于 目录 的 URI 能 
与 数据 库 多 行进 行 交互 。 


例如 ，content://com.personalcontactmanager.provider/contacts， 在 随后 的 章节 中 学 习 如 何 定义 和 使 用 它 。 


3. 声 明 contract 类 


对 于 建立 用 户 自 己 的 Content Provider， 声 明 一 个 contract 是 其 非常 重要 的 部 分 。 这 个 类 将 作为 Content Provider 和 应 用 程序 之 间 的 contract。 它 是 一 个 共有 的 、 不 能 被 继承 的 类 ， 包 含 URI 的 常量 定 
义 、 列 名 称 和 其 他 的 数据 。 虽 然 也 可 以 包含 Jjavadoc， 但 是 它 最 大 的 优点 是 开发 人 员 在 使 用 它 时 不 用 担心 会 导致 错误 的 表 名 、 列 名 和 常量 名 称 。 


contract 类 提供 了 必要 的 抽象 ， 当 有 需要 时 可 以 改变 底层 操作 方式 ， 还 可 以 改变 相应 的 数据 操作 从 而 影响 其 他 相关 应 用 程序 。 需 要 注意 的 一 点 是 ， 在 使 用 contract 类 时 要 非常 小 心 ， 因 为 修改 会 影响 到 
使 用 contract 类 的 其 他 应 用 程序 的 行为 。 


定义 的 contract 类 如 下 : 


public final class PersonalContactContract { 
public static final String AUTHORITY ="com.personalcontactmanager.provider"; 
public static final String BASE PATH = "contacts"; 
public static final Uri CONTENT URI = Uri. parse ("content:// " + AUTHORITY+ "/" + BASE ‚ PATH); 
public static final String CONTENT TYPE -ContentResolver.CURSOR DIR BASE ТҮРЕ +"/vnd.com.personalcontactmanager.provider.table" 
public static final String CONTENT ITEM TYPE = ContentResolver. CURSOR _ ITEM BASE TYPE +" "Ата. сот. а Su asa se provider: table_item" 
public static final String[] PROJECTION ALL = { "  id","contact name", "contact 1 number", "contact email", "photo id" }; 
// public static final String SORT ORDER | DEFAULT = NAME + " ASC" 
public static final class Columns t 
public static String TABLE ROW ID = " id"; 
public static String TABLE ROW NAME = "contact name" 
public static String TABLE ROW PHONENUM = "contact number" 
public static String TABLE ROW EMAIL = "contact email" 
public static String TABLE ROW PHOTOID = "photo id"; 
} 


} 


为 了 让 新 定义 的 Content Provider 被 应 用 程序 访问 ， 必 须 在 Android 系 统 中 注册 它 ，AUTHORITY 是 用 来 表示 该 Content Provider 的 注册 使 用 的 符号 名 称 。BASE_PATH 为 表 所 在 的 路 径 。 
CONTENT_URI 为 提供 者 所 包装 的 表 的 URI。CONTENT_TYPE 为 Android 平 台 基 于 MIME 类 型 的 内 容 URI， 它 包含 零 个 游标 或 多 个 项 目 。CONTENT_ITEM_TYPE 为 基于 Android 平 台 的 内 容 URI 的 MIME 类 
型 。PROJECTION_ALL 和 列 包 含 列 表 的 列 ID。 如 果 没 有 这 些 信息 ， 其 他 的 开发 人 员 将 无 法 访问 ， 即 使 资源 已 经 打开 。 


4 .创建 UriMatcher 


UriMatcher 是 一 个 工具 类 ， 其 主要 功能 是 辅助 Content Provider 匹 配 URI。addURI() 方 法 使 用 提供 者 应 该 识别 的 内 容 URI 模 式 ， 通 过 该 方法 添加 一 个 URI 以 便 系 统 匹 配 ， 如 果 URI 匹 配 后 代码 就 返 


回 


addURI (String authority, String path, int code) 


向 UriMatcher 类 的 addURI() 方 法 传递 参数 authority、path 模 式 和 一 个 整数 ， 并 调用 它 ， 


匹配 模式 定义 的 一 个 常 整数 值 。UriMatcher 类 应 该 类 似 于 如 下 代码 : 


" 
EJ 


private static final int CONTACTS TABLE = 1; 

private static final int CONTACTS TABLE ITEM = 2; 

private static final UriMatcher mmURIMatcher = new 

UriMatcher (UriMatcher.NO MATCH) ; 

static { Бы 

mmURIMatcher.addURI (PersonalContactContract.AUTHORITY, 
PersonalContactContract.BASE ‚ PATH, CONTACTS TABLE); 
mmURIMatcher.addURI (PersonalContactContract.j AUTHORITY, 
PersonalContactContract .BASE PATH+ "/#", CONTACTS TABLE ITEM); 
} 


上 述 类 的 定义 支持 使 用 通配符 ， 如 上 面 的 代码 片段 中 使 用 了 “#”， 还 可 以 使 用 诸如 “*” 的 通配符 。 


3.3.3 ”使 用 CRUD 基 本 函数 


1. 通 过 onCreate() 方 法 初始 化 Content Provider 


为 了 完整 地 建立 Content Provider， 接 下 来 的 步骤 是 访问 数据 库 的 核心 方法 ， 即 CRUD 方 法 。 它 们 是 用 户 与 数据 交互 的 核心 逻辑 ， 数 据 交 互 依赖 于 指定 的 插入 、 查 询 或 删除 操作 ， 实 现 Android 体 系 结 
构 中 生命 周期 方法 。 


在 onCreate() 方 法 内 建立 一 个 数据 库 管理 类 对 象 ， 这 应 该 是 在 主 UI 线 程 中 的 onCreate() 执 行 的 最 小 操作 ， 对 于 某 些 用 户 来 说 ， 可 能 会 引起 延迟 。 应 该 避免 在 OnCreate0 中 运行 时 间 长 的 任务 ， 因 为 它 会 
增加 提供 者 的 启动 时 间 。 还 有 一 种 做 法 是 推迟 数据 库 的 创建 或 装载 数据 ， 除 非 是 定义 的 Content Provider 接 受 的 数据 请 求 才 进行 这 些 操作 ， 实 际 就 是 将 持续 时 间 长 的 操作 移动 到 CRUD 方 法 中 。 


GOverride 

Public Boolean onCreate() { 
dbm = new DatabaseManager (getContext ()) ; 
return false; 


} 


2. 通 过 query() 方 法 查询 记录 


query() 方 法 会 返回 一 个 包含 结果 集 的 cursor 对 象 。URI 被 传递 给 UriMatcher， 查 看 是 否 匹配 先前 定义 的 任何 模式 。 在 switch-case 语 句 中 ， 如 果 是 一 个 table-item-related 的 case， 检 查 selection 语 名 
是 否 为 空 ， 如 果 是 这 样 ， 建 立 选择 语句 直到 lastpathsegment， 否 则 将 selection 追 加 到 lastpathsegment 的 后 面 。 用 DatabaseManager 对 象 在 数据 库 上 查询 并 获得 一 个 作为 结果 的 cursor。 如 果 传 递 了 一 


个 位 置 的 URI， 则 期 望 query() 能 抛 出 一 个 lllegalArguentException 异 常 。 如 果 在 执行 查询 过 程 时 遇 到 内 部 错误 ， 抛 出 一 个 nullPointerException 异 常 是 非常 好 的 处 理 方式 。 


GOverride 
public Cursor query(Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) ( 
int uriType = mmURIMatcher.match (uri); 
switch(uriType) ( 
case CONTACTS TABLE: 
break; ` 
case CONTACTS TABLE ITEM: 
if (TextUtils.isEmpty(selection)) { 
selection = PersonalContactContract.Columns. TABLE ROW ID* "=" + uri.getLastPathSegment () ; 
} else { 
selection = PersonalContactContract.Columns.TABLE ROW_ID+ "=" + uri. 
getLastPathSegment () +" and " + selection; Hrs 
} 
break; 
default: 
throw new IllegalArgumentException ("Unknown URI: " + uri); 
} 
Cursor cr = dbm.getRowAsCursor (projection, selection,selectionArgs, sortOrder) ; 
return cr; 


} 


3. 通 过 insert() 方 法 添加 记录 


insert() 方 法 是 用 来 向 数据 库 中 插入 数值 的 。 插 入 成 功 后 ， 返 回 插入 行 的 URI。 如 果 插 入 是 表 级 别 上 的 操作 ， 则 操作 方法 中 的 处 理 内 容 是 匹配 表 的 URI。 匹 配 后 ， 使 用 标准 的 DatabaseManager 对 象 将 新 
的 数据 插入 数据 库 中 。 新 数据 行 的 URI 是 通过 将 新 行 的 ID 值 追加 到 表 内 容 URI 之 后 而 构成 的 : 


GOverride 
public Uri insert(Uri uri, ContentValues values) ( 
int uriType - mmURIMatcher.match (uri); 
long id; 
switch(uriType) ( 
case CONTACTS TABLE: 
id = dbm.addRow (values); 
break; 
default: 
throw new IllegalArgumentException ("Unknown URI: " + uri); 
} 
Uri ur = ContentUris.withAppendedId(uri, id); 
return ur; 


} 


4. 通 过 update() 方 法 更 新 记录 


Update() 方 法 利用 ContentValues 参 数 中 的 值 更 新 对 应 表格 中 已 存在 的 行 数据 。 首 先 ， 标 识 一 个 URI 是 基于 目录 或 基于 ID 的 ， 然 后 建立 selection 语 句 ， 与 query() 方 法 类 似 。 随 后 执行 之 前 已 定义 好 的 
DatabaseManager 类 的 方法 updateRow()， 执 行 成 功 将 返回 所 影响 的 数据 的 行 数 。 


回 


Update() 方 法 返回 更 新 的 行 的 数目 ，selection 子 句 决定 了 更 新 一 行 还 是 多 行 数据 : 


GOverride 
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) ( 


int uriType = mmURIMatcher.match (uri); 
switch(uriType) ( 
case CONTACTS TABLE: 
break; 
case CONTACTS TABLE ITEM: 
if (TextUtils.isEmpty (selection)) { 


selection = PersonalContactContract.Columns.TABLE ROW Ір+ "=" + uri. 
getLastPathSegment () ; 
} eise { 
selection = PersonalContactContract.Columns.TABLE ROW_ID+ "=" + uri. 


getLastPathSegment ()+ " and " + selection; 
} 
break; 
default: 
throw new IllegalArgumentException ("Unknown URI: " + uri); 

} 
int count = dbm.updateRow(values, selection, selectionArgs) ; 
return count; 


} 


5. 通 过 delete() 方 法 删除 记录 


删除 行 的 数目 。 基 于 selection 子 句 ， 可 以 


n 


delete() 方 法 和 update() 方 法 很 相似 ， 且 使 用 它 去 删除 数据 的 过 程 也 与 更 新 数据 的 过 程 很 相似 ， 调 用 它 的 结果 是 删除 一 行 数据 而 不 是 更 新 它 。Delete() 方 法 返 
删除 一 行 或 多 行 数 据 : 


GOverride 
public int delete(Uri uri, String selection, String[] selectionArgs) { 
int uriType - mmURIMatcher.match (uri); 
switch(uriType) ( 
case CONTACTS TABLE: 
break; 
case CONTACTS TABLE ITEM: 
if (TextUtils.isEmpty (selection)) { 


selection = PersonalContactContract.Columns.TABLE ROW ID+ "=" + uri. 
getLastPathSegment () ; >= 
} else { 
selection = PersonalContactContract.Columns.TABLE ROW Ір+ "=" + uri. 


getLastPathSegment ()+ " and " + selection; 
} 
break; 
default: 
throw new IllegalArgumentException ("Unknown URI: " + uri); 
} 
int count = dbm.deleteRow (selection, selectionArgs) ; 
return count; 


} 


回 


类 型 


6. 通 过 getType() 方 法 获得 数据 的 返 


方法 getType() 需 要 一 个 URI 作 为 参数 并 返回 一 个 字符 串 值 ， 每 一 个 Content Provider 必 须 为 它 所 支持 的 URI 返 回 一 个 content type。 应 用 程序 不 需要 任何 权限 就 可 以 访问 这 种 信息 ; 即使 Content 
Provider 需 要 访问 权限 ， 所 有 的 应 用 程序 仍然 可 以 调用 该 方法 来 检索 MIME 类 型 。 所 有 的 MIME 类 型 应 该 在 contract 类 中 被 声明 : 


回 


GOverride 
public String getType(Uri uri) ( 
int uriType = mmURIMatcher.match (uri); 
switch(uriType) ( 
case CONTACTS TABLE: 
return PersonalContactContract.CONTENT TYPE; 


case CONTACTS TABLE ITEM: 
return PersonalContactContract.CONTENT ITEM TYPE; 
default: Е E 
throw new IllegalArgumentException ("Unknown URI: " + uri); 


3.3.4 注册 与 使 用 Content Provider 


1. 在 manifest 中 注册 Content Provider 


另 一 个 很 重要 的 步 又 就 是 将 Content Provider 添 加 到 manifest 中 ， 就 像 使 用 其 他 Android 组 件 一 样 。 可 以 注册 多 个 Content Provider。 注 意 一 点 ， 注 册 时 使 用 android:exported， 而 不 是 使 
android:authorities; 定义 了 该 Content Provider 是 否 能 被 其 他 的 应 用 程序 使 用 。 如 果 为 true， 该 Content Provider 能 被 其 他 的 应 用 程序 使 用 ; 否则， 不 能 使 用 。 如 果 应 用 程序 有 相同 的 用 户 ID(UID)， 也 
是 可 以 获得 访问 权限 的 : 


<provider 
android: name="com.personalcontactmanager.provider .PersonalContactProvider" 
android: authorities="com.personalcontactmanager.provider" 
android: exported="true" 
android: grantUriPermissions="true" > 
</provider> 


另 一 个 重要 的 概念 是 许可 证 。 可 以 通过 添加 附件 的 安全 机 制 ， 如 增加 读 或 写 的 权限 。 其 他 应 用 程序 在 它们 的 AndroidManifest.xml 文 件 中 必须 添加 读 或 写 权 限 ， 反 过 来 ， 自 动 通知 用 户 以 读 方式 、 写 方 
式 或 者 读 写 方式 使 用 Content Provider。 通 过 如 下 方式 添加 权限 : 


android: readPermission="com.personalcontactmanager.provider.READ" 


2. 使 用 Content Provider 


建立 了 一 个 Content Provider 的 主要 原因 是 允许 其 他 应 用 程序 访问 数据 库 中 复杂 数据 存储 和 执行 CRUD 操 作 。 下 面 通过 建立 更 多 的 应 用 程序 来 测试 新 建成 的 Content Provider。 测 试 应 用 程序 很 简单 ， 
只 包括 一 个 activity 类 和 一 个 布局 文件 。 使 用 标准 按钮 来 执行 操作 。 没 那么 复杂 ， 只 是 测试 刚 实现 的 功能 。 测 试 类 TestMainActivity 的 代码 如 下 所 示 : 


public class TestMainActivity extends Activity { 
public final String AUTHORITY = "com.personalcontactmanager.provider"; 
public final String BASE PATH = "contacts"; 
private TextViewqueryT, insertT; 
public class Columns ( 
public final static String TABLE ROW ID — " id"; 
public final static String TABLE ROW NAME = "contact name"; 
public final static String TABLE ROW PHONENUM — T 
"contact number"; 
public final static String TABLE ROW EMAIL = "contact email"; 
public final static String TABLE ROW PHOTOID = "photo id"; 
} 


为 了 访问 Content Provider， 需 要 更 多 的 细节 信息 ， 如 AUTHORITY 和 BASE_PATH 以 及 数据 库 表 的 列 的 名 称 ; 需要 访问 公共 类 Columns。 一 般 来 说 ， 所 有 这 些 必要 的 信息 都 可 以 从 content provider 
布 的 contract 类 中 获取 。 某 些 Content Provider 也 要 求 在 manifest 中 实现 读 取 或 写 入 权限 : 


«uses-permissionandroid:name-"AUTHORITY.permission.WRITE TASKS"/» 


在 某 些 情况 下 ， 需 要 访问 的 content provider 请 求 用 户 添加 权限 。 当 用 户 安装 应 用 程序 ， 在 权限 列表 中 会 找到 该 权限 : 


GOverride 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity test main); 
queryT = (TextView) findViewById(R.id.textQuery) ; 
insertT = (TextView) findViewById (R.id.textInsert); 


在 activity 类 中 的 onCreate() 方 法 中 设置 布局 和 初始 化 视 


。 为 了 查询 数据 ， 首 先 需要 准备 与 表 匹 配 的 URI 对 象 。 


D 


可 以 展现 Content Resolver 的 作用 了 ; 它 作 为 内 容 URI 的 解析 器 。 通 过 getContentResolver.query() 方 法 ， 将 获取 所 有 的 列 和 行 。 


public void query(View v) { 
Uri contentUri = Uri.parse("content:// " + AUTHORITY+ "/" + BASE PATH); 
Cursor cr = getContentResolver().query(contentUri, null,null, null, null); 
if (cr != null) { 
if (cr.getCount() » 0) ( 
cr.moveToFirst () ; 
String name = cr.getString (cr.getColumnIndexOrThrow ( 
Columns.TABLE ROW NAME) ) ; 
queryT.setText (name) ; 
š 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http://www. hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
} 


m 


可 以 通过 建立 URI 来 读 取 指定 的 行 ， 而 不 是 读 取 完整 的 表 。 通 过 添加 ID 到 已 经 存在 的 contenturi 来 构造 基于 1D 的 URI。 如 下 的 示例 代码 是 通过 建立 参数 映射 字符 
现 数据 查询 的 : 


数值 并 将 其 传递 给 query() 方 法 ， 来 实 


public void query(View v) { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/... 
Uri rowUri = contentUri = ContentUris.withAppendedld (contentUri, getFirstRowId() y 
String[] projection = new String[] { 
Columns.TABLE ROW NAME, Columns.TABLE ROW PHONENUM, 
Columns.TABLE ROW EMAIL, Columns.TABLE ROW PHOTOID }; 
cr = getContentResolver ().query (contentUri, projection, 
null, null, null); 
if (cr != null) { 
if (cr.getCount() » 0) ( 
cr.moveToFirst(); 
String name = cr.getString(cr.getColumnIndexOrThrow (Columns .TABLE ROW NAME)); 
queryT.setText (name) ; 


getFirstRowID() 方 法 获得 表 中 的 第 一 行 的 ID。 因 为 第 一 行 的 ID 并 不 总 是 1， 它 会 因为 数据 行 被 删除 而 改变 。 如 果 在 表 中 行 ID 为 1 的 第 一 项 被 删除 ， 则 第 二 项 的 行 ID 为 1 并 成 为 第 一 个 项 


private int getFirstRowId() { 
int id = 1; 
Uri contentUri = Uri.parse("content:// " + AUTHORITY + "/"+ "contacts"); 
Cursor cr = getContentResolver().query(contentUri, null,null, null, null); 
if (cr != null) { 
if (cr.getCount() > 0) í 
cr.moveToFirst (); 
id = cr.getInt (cr.getColumnIndexOrThrow (Columns. TABLE ROW ID)); 
} 
$ 


return id; 


进一步 探究 query() 方 法 : 


public final Cursor query (Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) 


query() 方 法 返回 参数 指定 的 结果 集 的 游标 对 象 ， 以 下 是 上 述 代 码 的 参数 : 
- uri: contentURI: 为 待 检索 内 容 设置 content:// 方 案 ， 它 可 以 是 基于 ID 的 或 基于 目录 的 。 


+ projection: 根据 用 户 的 需要 返回 列 的 列表 。 传 递 null 将 返回 所 有 列 。 


< selection: 格式 化 为 SQL 语句 的 WHERE 子 句 ， 排 除 WHERE 本 身 ， 将 其 作为 一 个 返回 行 数据 的 滤波 器 。 


+ selectionArgs: selection 中 的 参数 标记 。Android 的 SQL 查询 生成 器 将 使 用 selectionArgs 中 的 值 按 顺序 替代 selection 中 的 所 有 festus 


+ sortOrder: 如 何 对 行进 行 排序 ， 格 式 化 为 一 个 ORDER BY 子 句 。 传 递 null 值 将 使 用 默认 的 排序 顺序 。 


建立 内 容 的 值 对 象 和 相关 的 键 值 对 ， 例 如 ， 一 个 电话 号 码 中 的 相应 的 Columns.TABLE_ROW_PHONENUM 字 段 。 
需要 通过 列 类 访问 它 。 这 确保 了 用 户 只 需要 更 新 相关 的 数值 即 可 。 如 果 在 以 后 Content Provider 发 生 了 一 些 变化 ， 其 余 功能 和 实现 保持 相同 。 


因 


为 有 些 详细 信息 ， 如 列 的 名 字 都 以 类 形式 告诉 用 户 了 ， 所 以 用 户 不 用 担心 细节 ， 只 


建立 content URI， 注 意 到 它 是 匹配 表 而 不 是 单个 列 。 不 像 query0 方 法 返回 一 个 包含 数据 集 的 游标 ，Insert() 方 法 会 返回 一 个 URI。 


public void insert(View v) { 
String name = getRandomName () ; 
String number = getRandomNumber (); 
ContentValues values = new ContentValues (); 
values.put (Columns.TABLE ROW NAME, name); 
values.put (Columns.TABLE ROW PHONENUM, number); 
values.put (Columns. TABLE ROW EMAIL, name + "@gmail.com"); 
values.put (Columns.TABLE ROW PHOTOID, "abc"); 
String[] projection = new String[] { 
Columns.TABLE ROW NAME, 
Columns.TABLE ROW PHONENUM,Columns.TABLE ROW EMAIL, Columns.TABLE ROW PHOTOID }; 
Uri contentUri = Uri.parse("content:// " + AUTHORITY + "/"+ BASE PATH); 
Uri insertedRowUri = getContentResolver ().insert (contentUri, values); 
Cursor cr = getContentResolver().query(insertedRowUri,projection, null, null, null); 
if (cr != null) { 
if (cr.getCount() > 0) { 
cr.moveToFirst () ; 
name = cr.getString(cr.getColumnIndexOrThrow (Columns.TABLE_ROW_NAME) ) ; 
insertT.setText (name); 


getRandomName() 方 法 与 getRandomNumber() 方 法 


上 产 随 机 名 称 和 随机 数 : 


private String getRandomName () { 
Random rand = new Random(); 
String name = "" + (char) (122-rand.nextInt (26)) 


* (char) (122-rand.nextInt (26)) 
+ (char) (122-rand.nextInt (26)) 
+ (char) (122-rand.nextInt (26) ) 
+ (char) (122-rand.nextInt (26) ) 
+ (char) (122-rand.nextInt (26) ) 
+ (char) (122-rand.nextInt (26) ) 
+ (char) (122-rand.nextInt(26)) ; 


return name; 
} 
public String getRandomNumber() { 
Random rand = new Random () ; 
String number = rand.nextInt (98989) *rand.nextInt (59595) +""; 
return number; 


} 


方法 insert0 是 非常 常用 的 ， 下 面 将 详细 说 明 : 


public final Uri insert (Uri url, ContentValues values) 


下 面 是 上 述 代码 的 参数 : 
шй: 表示 待 插 入 数据 表 的 URL 


“values: 是 以 ContentValues 形 式 保存 的 将 要 插入 的 新 的 数据 值 ， 键 为 字段 的 列 名 。 


在 插入 后 , 利 


利用 准备 好 的 ContentValues 对 象 执行 insert() 方 法 ， 类 似 地 ， 在 调用 ContentResolver 对 象 的 update() 方 法 时 也 需要 准备 数据 对 象 。 


insert( 返 回 的 URI 执 行 query() 方 法 ， 这 样 做 是 为 了 确认 一 下 打算 插入 到 数据 库 中 的 数据 是 否 已 经 插入 了 。 


因 


为 该 操作 是 大 了 


FID 的 ， 所 以 要 建立 基于 ID 的 URI。 更 新 的 记录 是 


由 rowUri 指 定 的 ， 返 回 被 更 新 的 行 数 。 另 一 种 方法 ， 可 以 使 用 contentUri 的 组 合 及 selection/selectionArgs 完 成 对 数据 的 更 新 。 在 这 种 情况 下 ， 更 新 的 行 数 可 以 不 止 一 个 ， 而 是 由 selection 子 句 指定 : 


public void update (View v) { 


String name 


String number 


getRandomName () ; 
= getRandomNumber () ; 


ContentValues values = new ContentValues () ; 

values.put (Columns. TABLE ROW NAME, name); 

values.put (Columns. TABLE ROW PHONENUM, number); 

values.put (Columns.TABLE ROW EMAIL, name + "@gmail.com"); 

values.put (Columns.TABLE ROW PHOTOID, " "); 

Uri contentUri = Uri.parse("content:// " + AUTHORITY+ "/" + BASE PATH); 
Uri rowUri = ContentUris.withAppendedId (contentUri, getFirstRowlId()); 


int count = getContentResolver().update(rowUri, values, null, null); 


} 


再 来 说 说 update() 方 法 : 


public final int update (Uri uri, ContentValues values, String where,String[] selectionArgs) 


下 面 是 上 述 代码 的 参数 : 


Dun: 需要 修改 的 数据 的 content URI. 


“ values: 该 参数 与 前 面 的 其 他 方法 中 的 使 用 方式 一 致 ; 传递 空 值 将 删除 现 有 的 字段 值 。 


+ where: whete 子 句 过 滤 需 要 更 新 的 数据 行 。 


可 以 再 次 运行 query() 方 法 来 查看 是 否 更 改 成 功 。 


最 后 一 个 方法 是 delete() 方 法 ， 首 先 ， 在 目录 级 准备 content URI， 然 后 在 ID 级 构建 它 ， 也 就 是 在 独立 的 行 级 构建 它 ， 之 后 ， 把 它 传递 给 ContentResolver 类 的 delete() 方 法 。 与 query0 和 insert(0 返 回 一 


个 整数 值 不 同 ，delete() 方 法 删除 基于 ID 对 象 rowUri 指 定 的 数据 行 ， 返 


回 


被 删除 的 行 数 。 如 URI 指 向 一 行 ， 返 回 


在 这 种 情况 下 ， 被 删除 的 行 根据 selection 子 句 所 限定 ， 删 除 的 行 数 不 止 一 个 : 


的 结果 就 是 1。 另 一 种 可 选 的 方法 ， 可 以 使 有 


contentUri 和 selection/selectionArgs 的 组 合 。 


public void delete(View v) { 


Uri contentUri = Uri.parse("content:// " + AUTHORITY+ "/" + BASE PATH); 
Uri rowUri = contentUri = ContentUris.withAppendedId(contentUri, getFirstRowId()); 
int count = getContentResolver().delete(rowUri, null,null); 


} 


程序 的 界面 如 图 3-5 所 示 。 
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图 3-5 ”程序 的 界面 


34 基于 SQLite 数 据 库 的 日 记 账 工具 


通过 前 面 的 介绍 ， 我 们 对 SQLite 数 据 库 的 使 用 


模式 应 该 有 了 一 定 的 了 解 。 接 下 来 将 介绍 一 款 基 于 SQLite 数 据 库 的 日 记 账 工具 来 巩固 对 SQLite 数 据 库 应 用 


的 理解 。 该 日 记 账 工具 的 实例 界面 ， 如 


图 3-6 所 
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图 3-6 日记账 工具 界面 


1. 程 序列 表 


日 记 账 工具 程序 的 列表 文件 (AndroidManifest.xml) 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8"?> 

<manifest xmlns:android="http:// schemas.android.com/apk/res/android" 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/...> 
«application android:icon="@drawable/icon" android:label="@string/app_name"> 

<activity android:name=".SQLiteDBJournalBookAct" T 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/...> 
</activity> 

<activity android:nam 
<activity android: 
<activity android: 
<activity android: 
<activity android: 
</application> 
<uses-sdk android:minSdkVersion="8" /> 

«uses-permission android:name-"android.permission.WRITE EXTERNAL STORAGE"/> 
«/manifest» Е E 


DBConfigAct"></activity> 

AppendRecAct"></activity> 
ReviewRecAct"></activity> 
LookupRecAct"»«/activity» 
.ReportRecAct"»«/activity» 


通过 以 上 代码 可 以 看 出 ， 除 了 主 Activity 组 件 ， 还 包含 5 个 Activity 组 件 (588678581247) 。 


2. 用 户 界面 


主 Activity 调 用 功能 Activity 通 过 选项 菜单 的 方式 来 实现 ， 程 序 的 选项 菜单 如 图 3-7 所 示 。 
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SQLiteJournalBookApp 


Journal Book 


Lookup 


主 Activity 组 件 的 布局 资源 定义 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http:// schemas.android.com/apk/res/android" 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...» 


<ImageView 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 


android: srce="@drawable/login_bkg" /> 
</LinearLayout> 


主 Activity 组 件 中 可 选 菜单 的 定义 代码 如 下 : 


<menu xmlns:android="http:// schemas.android.com/apk/res/android"> 
<group> 
<item android:title="Database" 
android: orderInCategory="0" 
android: icon="@drawable/db" 
android: id="@+id/MI_CONFIG"> 
</item> Е 
«/group» 
«group» 


<item android: id="@+id/MI_APPEND" 
android: title="Append" 
android: orderInCategory="0" 
android: icon="@drawable/append"> 
</item> 
<item android: id="@+id/MI_REVIEW" 
android:title-"Review" 
android:orderInCategory-"1" 
android: icon="@drawable/preview"> 
</item> 
<item android: id="@+id/MI_LOOKUP" 
android:title-"Lookup" 
android:orderInCategory-"2" 
android: icon="@drawable/lookup"> 
</item> 
«/group» 
«group» 
<item android:id="@+id/MI_ABOUT" 
android:title-"About" | 
android: orderInCategory="3" 
android: icon="@drawable/about"> 
</item> 
<item android: id="@+id/MI_QUIT" 
android:title="Quit" 7 
android: orderInCategory="4" 
android: icon="@drawable/quit"> 
</item> 
«/group» 
«/menu» 


3. 主 Activity 代 码 框架 


以 下 是 日 记 账 工具 程序 的 主 Activity 代 码 框架 ， 在 该 框架 中 主 Activity 对 功能 Activity 进 行 调用 。 


public class SQLiteDBJournalBookAct extends Activity { 
// 退出 和 关于 对 话 框 ID 
static final int QUIT DLG = 0; 
static final int ABOUT_DLG = 1; 
// 退出 和 关于 对 话 框 组 件 
private AlertDialog mQuitDlg = null; 
private Dialog mAboutDlg = null; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main view); 


} 
GOverride 
public boolean onCreateOptionsMenu (Menu menu) { 
// 填充 菜单 
MenuInflater inflater = getMenuInflater (); 
inflater.inflate(R.menu.options_menu, menu); 
// 设置 Intent 菜 单 
menu.findItem(R.id.MI CONFIG) .setIntent ( 

new Intent (this, DBConfigAct.class) ); 
menu. findItem(R.id.MI APPEND) .setIntent ( 

new Intent (this, AppendRecAct.class) ); 
menu. findItem(R.id.MI_REVIEW) .setIntent ( 

new Intent (this, ReviewRecAct.class) ); 
menu.findItem(R.id.MI_LOOKUP) .setIntent ( 

new Intent (this, LookupRecAct.class) ); 
// 注意 : 必须 要 调用 超 类 的 方法 ， 否 则 无 法 实现 Intent 回 调 


return (super.onCreateOptionsMenu (menu) ); 


} 
// 初始 化 对 话 框 
protected Dialog onCreateDialog(int id) { 
switch(id) { 
case QUIT DIG: 
return (initQuitDlg() ); 
case ABOUT DLG: 
return (initAboutDlg() ); 
default: 
return null; 


} 


} 
GOverride 
public boolean onOptionsItemSelected (MenuItem item) { 
switch(item.getItemId() ) { 
case R.id.MI ABOUT: { 


doAbout () ; 
break; 


} 
case R.id.MI QUIT: ( 
doQuit () ; 
break; 
} 
l 
return (super.onOptionsItemSelected(item) ); 
$ 
H 


在 上 述 代码 中 ， 在 创建 可 选 菜单 的 回调 方法 ( "onCreateOptionsMenu" ) 时 ， 通 过 Activity 所 关联 的 菜单 填充 器 (Menu 
的 “setlntent” 方 法 来 设置 菜单 项 所 绑 定 的 Activity 组 件 。 其 中 退出 对 话 框 和 关于 对 话 框 与 Activity 组 件 绑 定 。 


nflater) 来 “填充 ”可 选 菜单 资源 ， 然 


后 通过 菜单 项 实例 


另 一 方面 ，Activity 组 件 通 过 创建 对 话 框 的 回调 方法 (“onCreateDialog”) 来 初始 化 退出 对 话 框 和 关于 对 话 框 。 在 可 选 菜 单项 目 被 选 


断 菜单 项 的 标识 来 处 理 关 于 菜单 项 是 否 退 出 菜单 的 选择 事件 。 


取 事 件 的 回调 方法 ( "onOptionsltemSelected" ) 中 ， 通 过 判 


在 以 上 代码 中 出 现 了 两 种 菜单 项 的 绑 定 方式 : 第 1 种 方式 是 在 初始 化 可 选 菜单 时 ， 直 接 通 过 菜 


间 的 回调 函数 设置 指定 菜单 项 的 响应 函数 。 


项 对 象 实例 的 “setlntent” 方 法 将 该 项 


与 Activity 组 件 进行 绑 定 ; 第 2 种 方式 是 通过 可 选 菜单 项 选择 时 


如 果 说 第 2 种 方式 是 处 理 菜单 项 选择 事件 的 传统 方式 ， 那 么 第 1 种 方式 便 可 以 理解 为 Android 平 台 为 菜单 项 提供 的 一 种 用 于 调用 Activity 组 件 的 简洁 方式 ， 因 为 大 多 数 场合 下 ， 开 发 者 都 利用 菜单 来 启动 其 
他 的 Activity 组 件 。 


也 就 是 说 ， 通 过 第 2 种 方式 也 是 可 以 调用 Activity 组 件 的 ， 只 不 过 需要 开发 者 显 式 地 通过 Intent 对 象 来 启动 Activity (通过 “startActivity”) 。 


4. 配 置信 息 接 


为 了 便于 管理 日 记 账 工具 程序 中 的 配置 信息 ， 可 以 将 配置 信息 定义 到 配置 信息 接口 中 。 配 置信 息 接口 的 定义 代码 如 下 : 


public interface Config { 

// 数据 库 路 径 

public static final String DATABASE NAME = "/sdcard/JournalBook.db"; 
// 数据 表 名 

public static final String TABLE PAYOUT = "Payout"; 

H 


5.SQLite 数 据 库 工具 类 


为 了 统一 对 SQLite 数 据 库 的 使 用 ， 可 以 将 一 些 SQLite 数 据 库 的 常用 操作 (例如 : 打开 /关闭 数据 库 、 执 行 SQL 语 句 、 执 行 查询 获取 结果 集 、 游 标 移动 、 获 取 列 内 容 等 ) 封装 成 工具 类 。 以 下 是 该 SQLite 工 
具 类 的 定义 代码 : 


public class SQLiteUtil { 

// SQLite 数 据 库 公共 函数 库 

public static final String SQLite MASTER TABLE = "sqlite master"; 
// 单 例 模式 提供 接口 

private static SQLiteUtil mInstance = new SQLiteUtil(); 

private SQLiteUtil() { 


} 
// 单 例 接口 
public static SQLiteUtil getInstance() { 
return (mInstance) ; 


} 
// 打开 数据 库 
private SQLiteDatabase openDB (String dbName) { 
File file = new File (dbName) ; 
if(file.exists() = true) ( // 库 文 件 存在 则 打开 数据 库 
return (SQLiteDatabase.openDatabase (dbName, null, SQLiteDatabase.OPEN 
READWRITE) ); B 


} 
else { // 如 果 不 存在 则 初始 化 

return (SQLiteDatabase.openOrCreateDatabase (dbName, null) ); 
] 


} 
// 关闭 数据 库 
private void closeDB(SQLiteDatabase db) { 
db.close(); 


} 
// 删除 数据 库 
public boolean deleteDB (String dbName) { 
File file = new File (dbName) ; 
Log.d(this.getClass().getName(), file.getAbsolutePath() ); 
if(file.exists() == true) ( // 库 文 件 存在 则 删除 
return (file.delete() ); 
} 


return (true); 


} 
// 在 指定 数据 库 中 执行 指定 SQL 语句 
public void execQuery(String dbName, String sql) { 
SQLiteDatabase db = openDB (dbName) ; 
db.execSQL (sql); 
closeDB (ар); 


l 
// 打开 查询 ， 获 取 结 果 集 游标 
public Cursor openQuery (String dbName, String tableName, String condStr) { 
SQLiteDatabase db = openDB (dbName) ; 
Cursor cursor = db.query(tableName, null, condStr, null, null, null, null); 
// 游标 复位 
cursor.moveToFirst (); 
// 关闭 文件 
closeDB (db) ; 
return (cursor); 


} 
// 获取 结果 集 记录 行 数 
public int getRowsCount (Cursor cursor) { 
return (cursor.getCount() ); 


} 
// 获取 结果 集中 的 列 数 
public int getColumnsCount (Cursor cursor) { 
return (cursor.getColumnCount() ); 


] 
// 通过 列 索引 获取 列 名 
public String getColumnNameBy (Cursor cursor, int index) { 
return (cursor.getColumnName (index) ); 
} 
// 判断 是 否 为 游标 
public boolean isBOF(Cursor cursor) { 
return (cursor.isBeforeFirst ()); 


} 
// FUR RGA BAL 
public boolean isEOF(Cursor cursor) { 
return (cursor.isAfterLast () ) 


} 
// 移动 到 下 一 条 记录 
public boolean moveNext (Cursor cursor) { 
return (cursor.moveToNext () ); 


} 
// 获取 记录 游标 的 当前 行 指定 位 置 列 的 内 容 
public String getField(Cursor cursor, int index) { 
return (cursor.getString (index) ); 


} 
// 关闭 结果 集 
public void closeQuery (Cursor cursor) { 
cursor.close(); 
} 
// 判断 指定 数据 库 中 的 数据 表 是 否 存在 
public boolean isTableExists (String dbName, String tableName) { 
Cursor cursor = openQuery(dbName, SQLite MASTER TABLE, "(tbl name-'" 
+tableName+"')") 7 
int recordCount = cursor.getCount () ; 
cursor.close(); 
return (recordCount > 0); 


1; 


6 .配置 数据 库 


配置 数据 库 包 括 初 始 化 数据 库 和 删除 数据 库 ， 其 界面 如 图 3-8 所 示 。 


以 下 是 初始 化 数据 库 的 主要 代码 : 
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atabase config 


Init database 


Drop database 


图 3-8 ”数据 库 配置 界面 


// 初始 化 数据 库 
private void doInit() { 


// 首先 判断 数据 表 是 否 存在 


if (SQLiteUtil.getInstance () .isTableExists (Config.DATABASE NAME, 


Config.TABLE PAYOUT) == false) { 
// i&ii"CREATE TABLE"GE 4) ЖЖ k 


String sql = "create table " + Config.TABLE PAYOUT + 
"(Timestamp TEXT primary key, Comments TEXT, Money TABLE PAYOUT)"; 


// 通过 指定 数据 库 名 来 执行 查询 


SQLiteUtil.getInstance() .execQuery(Config.DATABASE NAME, sql); 
FoolUtil.showMsg(this, "Create table " + 
Config.TABLE_PAYOUT + " successfully!"); 


} 
else { 
FoolUtil.showMsg(this, "Table " + 


Config.TABLE PAYOUT + " already exists!"); 


在 上 述 代 码 中 ， 首 先 判断 目标 数据 表 是 否 存 在 ， 如 果 目 标 数据 表 不 存在 则 通过 执行 “CREATE TABLE” SQL 语句 来 创建 数据 表 ， 创 建 完毕 则 提示 数据 表 创 建成 功 的 消息 ， 


在 ， 那 么 程序 在 创建 数据 表 之 前 还 会 自动 创建 数据 库 (Ud 


“openDB” 方法) ， 该 数据 库 文件 会 在 指定 路 径 中 找到 ， 如 图 3-10 所 示 。 


如 


3-9 所 示 。 如 果 数 据 库 不 存 
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Create table Payout successfully! 


mnt sdcard 


图 3-10 ”数据 文件 路 径 信息 


Append record 


图 3-11 添加 日 记 账 记录 的 界面 


以 下 是 删除 数据 库 的 主要 代码 : 


private void doDrop() { 
if (SQLiteUtil.getInstance () .deleteDB(Config.DATABASE_ NAME) ) { 
FoolUtil.showMsg(this, "Drop database successfully!"); 
} 
else { 
FoolUtil.showMsg(this, "Database not exists!"); 
} 
} 


在 上 述 代码 中 ， 如 果 删 除数 据 库 成 功 则 提示 数据 库 删除 成 功 的 消息 。 


7. 添 加 日 记 账 记录 


通过 选择 添加 菜单 项 (“Append”) 所 启动 的 记录 添加 Activity 组 件 的 界面 ， 如 图 3-11 所 示 。 


添加 日 记 账 记录 的 主要 代码 如 下 : 


// 提交 记录 
private void doSubmit() { 
if (submitCheck() == false) {// 提交 检查 
return; 


li 

// 构建 INSERT INTO#E 4) 

String sql = "insert into " + Config.TABLE PAYOUT + 
"(timestamp,comments,money) values('" + 


mTxtTimestamp.getText().toString().trim() + "','" + 
mTxtComments.getText().toString().trim() + "'," + 
mTxtMoney.getText().toString().trim() + ")"; 
// 执行 插入 语句 
SQLiteUtil.getInstance() .execQuery(Config.DATABASE NAME, sql); 
FoolUtil.showMsg (this, "Store record successfully!"); 
this.finish(); 


} 
// 提交 检查 
private boolean submitCheck() { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 


} 


在 上 述 代 码 中 ， 依 据 用 户 的 输入 内 容 构建 “INSERT INTO” 语 句 ， 然 后 利用 SQLite 工 具 类 执行 SQL 的 “execQuery” 方 法 来 执行 该 语句 ， 来 插入 记录 。 当 记录 添加 成 功 ，Activity 组 件 会 显示 提示 信息 ， 


并 且 结 束 本 次 运行 ， 界 面 返回 到 主 Activity， 如 图 3-12 所 示 。 


8 .查看 日 记 账 记录 


3-13 所 示 。 


D 


通过 选择 应 用 程序 功能 框架 中 的 查看 菜单 项 (“Review”) 所 启动 的 记录 来 查看 Activity 组 件 的 界面 ， 如 


uccessfull 


图 3-12 ”记录 添加 成 功 后 提示 
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Review record (1/3) 


mstamp: 


2012/5/15 8:27:8 


图 3-13 ”查看 记录 


获取 日 记 账 记录 的 主要 代码 如 下 : 


// 记录 数量 
Private int mRecordCount = 0; 
// 记录 对 象 容器 
private ArrayList<Payout> mRecordSet = null; 
// 初始 化 数据 集 
private void initDataSet() { 
Cursor cursor = 
SQLiteUtil.getInstance ().openQuery (Config.DATABASE NAME, 
Config.TABLE PAYOUT, null); 
mRecordCount = cursor.getCount (); 
if (mRecordCount > 0) { 
mRecordSet = new ArrayList«Payout» (mRecordCount); 
while(!cursor.isAfterLast()) ( 

Payout payout = new Payout (cursor.getString(0), 
cursor.getString(1), 
cursor.getDouble(2) ); 

mRecordSet .add (payout) ; 

cursor.moveToNext () ; 


t 


cursor.close(); 


在 上 述 代码 中 ， 通 过 SQLite 工 具 类 的 “openQuery” 方 法 获取 日 记 账 数据 表 中 的 所 有 记录 。 通 过 遍历 结果 集 游标 ， 获 取 各 行 的 列 内容 ， 并 通过 每 一 行 的 列 内 容 来 构造 一 个 支出 对 象 ， 这 些 结果 集 都 会 
加 到 记录 对 象 容器 中 。 


户 通过 “Next” 和 “Prev” 按 钮 改变 当前 记录 的 索引 值 ， 就 可 以 从 记录 对 象 容器 中 获取 对 应 的 记录 对 象 ， 并 显示 该 记录 对 象 的 内 容 。 显 示 记录 对 象 容器 中 当前 索引 位 置 的 记录 对 象 的 主要 代码 如 下 : 


// 显示 记录 内 容 
private void showRecord () 
// 获取 当前 索 ТОРИЯ 
Payout payout = mRecordSet.get (mRecordIndex) ; 
// 设置 抬头 
mPrevieTitle.setText ("Review record (" + 
(mRecordIndex+1) + "/" + mRecordCount + ")"); 
// 设置 界面 组 件 的 文本 内 容 


mTxtTimestamp.setText (payout.getTimestamp() ); 
mTxtComments.setText (payout.getComments() ); 
mTxtMoney.setText (String.valueOf (payout.getMoney()) ); 


如 果 当 前 记录 索引 是 最 后 一 条 记录 时 ， 则 “Next” 按 钮 将 不 可 用 ; 如 果 当 前 记录 是 第 一 条 记录 时 ， 则 “Prev” 按 钮 将 不 可 用 ; 只 有 当前 记录 在 中 间 时 ，“Next” 和 “Prev” 按 钮 才 都 可 用 ， 如 图 3-14 
所 示 。 
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图 3-14 通过 “Next” 和 “Prev” 按 钮 控制 记录 显示 


9. 记 录 对 象 定义 


在 “获取 日 记 账 记录 内 容 ” 的 代码 中 ， 作 者 将 结果 集中 的 每 一 行 与 每 一 个 对 象 进行 对 应 ， 而 该 过 程 可 以 视 为 ORM (Object Relational Mapping， 对 象 关系 映射 ) 的 逆 过 程 ， 即 通过 数据 库 中 的 持久 信 
息 来 构建 对 象 实例 。 而 在 “显示 记录 对 象 ”的 代码 中 ， 又 将 记录 对 象 的 属性 与 可 视 化 组 件 进行 绑 定 ， 实 现 对 象 的 显示 。 


日 记 账 记录 中 记录 所 对 应 的 对 象 类 型 的 定义 代码 如 下 : 


public ponas Payout implements Parcelable { 
// 属性 信息 
http: //www.hzcourse. com/resource/readBook?path=/openresources/teach « ebook/uncompressed/15338/OEBPS/Text/.. 
// 必须 要 有 一 个 名 为 CREATOR 的 成 员 对 象 ， 否 则 无 法 进行 Parcelalbble 对 象 通信 

public static final Parcelable.Creator<Payout> CREATOR = new Parcelable. 
Creator<Payout> () { 

public Payout createFromParcel (Parcel in) { 

return new Payout (in); 


} 
public Payout[] newArray(int size) { 
return new Payout [size]; 


ayout (String timestamp, String comments, double money) { 
mTimestamp = timestamp; 

mComments = comments; 

mMoney = money; 


} 

// 属性 的 getter 方 法 和 setter 方 法 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/... 
// 实现 Parcelable 接 口 
public Payout (Parcel in) { 

this.mTimestamp = in.readString(); 

this.mComments = in.readString(); 

this.mMoney = in.readDouble(); 


} 
// 实现 Parcelable 接 口 
@Override 
public void writeToParcel (Parcel dest, int flags) { 
/ TODO Auto-generated method stub 
dest .writeString (this.mTimestamp) ; 
dest .writeString(this.mComments) ; 


dest .writeDouble (this .mMoney) ; 
б 
1; 


在 上 述 代码 中 ， 由 于 该 记录 对 象 需要 在 Activity 组 件 之 间 进 行 传递 ， 所 以 该 对 象 必须 实现 Parcelable 接 口 。 


通过 选择 应 用 程序 功能 结构 中 查询 菜单 项 (“Lookup”) 所 启动 的 记录 查询 Activity 组 件 的 界面 ， 如 图 3-15 所 示 。 
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图 3-15 ”记录 查询 界面 


查询 日 记 账 记录 的 主要 代码 如 下 : 


// 执行 查询 动作 
private void doQuery() { 
// 生成 查询 条 件 字符 串 
String condStr = makeConditonStr(); 


// 打开 查询 
Cursor cursor = SQLiteUtil.getInstance () .openQuery ( 
Config.DATABASE NAME, 
Config.TABLE PAYOUT, condStr); 
int recordCount = cursor.getCount () ; 
if(recordCount > 0) { 
ArrayList<Payout> recordSet = new ArrayList<Payout>(recordCount) ; 
while(!cursor.isAfterLast()) {// 遍历 结果 集 
Payout payout = new Payout (cursor.getString(0), 
cursor.getString(1), 
cursor.getDouble (2) ); 
recordSet.add (payout) ; 
cursor.moveToNext () ; 
} 
cursor.close(); 
Intent reportRecIntent - new Intent(this, ReportRecAct.class); 
reportRecIntent.putParcelableArrayListExtra (EXTRA NAME, recordSet); 
this.startActivity (reportRecIntent); = 
} 
е1зе { 
FoolUtil.showMsg(this, "The result of query is null, pls try again!"); 
return; 


} 


} 
// 生成 条 件 字符 串 
private String makeConditonStr() { 
// 获取 列 名 
String columnName = mSpnColumns.getSelectedItem() .toString(); 
// 获取 操作 名 
String operator = mSpnOperators.getSelectedItem() .toString(); 
// 获取 参考 值 
String value = mTxtValue.getText () .上 toString () .trim(); 
StringBuffer sb = new StringBuffer (columnName) ; 
sb.append(' '*operatort' '); 
// 字符 串 变量 需要 使 用 引号 


if( (columnName.compareToIgnoreCase ("Timestamp") == 0) | 


| 
(columnName.compareToIgnoreCase ("Comments") == 0) ) í 
if (operator.compareToIgnoreCase ("=") == 0) { // 精确 比较 
sb.append('\''); 
sb.append (value) ; 
sb.append('\''); 
} 
else if (operator.compareToIgnoreCase ("LIKE") == 0) { // 模糊 查询 


sb. append ("\'%"); 

sb.append (value) ; 

sb.append ("$N'") ; 
l 


} 
else ( // 金额 变量 无 需 使 用 引号 
sb.append (value); 


} 
FoolUtil.printLog(this, sb.toString() ); 
return (sb.toString() ); 


i 


以 上 代码 与 “获取 记录 内 容 ” 代 码 都 包含 了 对 数据 库 的 查询 操作 ， 不 同 的 是 ，“ 获 取 日 记 账 记录 内 容 ” 中 代码 的 查询 条 件 为 空 ， 而 上 面 的 代码 中 允许 用 户 自 定义 查询 条 件 ， 程 序 会 根据 用 户 的 选择 来 生 
成 查询 条 件 。 


在 构建 查询 条 件 的 方法 (“makeConditionStr”) 中 通过 列 名 、 操 作 符 和 参考 值 这 3 个 参数 来 构建 条 件 字符 串 。 其 中 列 名 和 操作 符 的 内 容 通过 数组 资源 的 方式 进行 定义 ， 其 定义 代码 如 下 所 示 : 


<resources> 

<string-array name="columns"> 
<item>Comments</item> 
<item>Timestamp</item> 
<item>Money</item> 

</string-array> 

<string-array name="operators"> 
<item>LIKE</item> 
<item>=</item> 
«item»&gt;«/item» 
<item>&lt;</item> 

</string-array> 

</resources> 


当 查 询 完 毕 时 ， 程 序 将 会 启动 一 个 以 列表 的 方式 查看 记录 的 Activity 组 件 来 显示 查询 结果 ， 记 录 查 询 Activity 还 会 将 查询 所 返回 的 结果 集 通过 Intent 的 附加 空间 传递 给 列表 查看 Activity 组 件 ， 该 列表 查看 
记录 的 Activity 组 件 的 界面 如 图 3-16 所 示 。 


D 


11. 日 记 账 记录 列表 
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来 显示 通过 Intent 对 象 空间 传递 过 来 的 记录 容器 中 的 内 容 。 


3-16 中 所 示 的 使 用 列表 方式 显示 查询 结果 的 Activity 实 际 上 是 一 个 ListActivity 组 件 ， 用 列表 视 | 
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12. 关 于 对 话 框 


通过 选择 应 用 程序 功能 结构 中 的 关于 菜单 项 ( "About" ) 所 显示 的 对 话 框 界面 如 图 3-17 所 示 。 
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8316 ”列表 显示 查询 结果 
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About JournalBook 


3-17 日 记 账 工 具 关 于 对 话 框 


用 图 3-17 所 示 的 对 话 框 的 主要 代码 旭 


public class SQLiteDBJournalBookAct extends Activity { 
// 关于 对 话 框 ID 
static final int ABOUT_DLG = 
// 关于 对 话 框 组 件 
private Dialog mAboutDlg = null; 
// 初始 化 对 话 框 
protected Dialog onCreateDialog 
switch(id) { 
case ABOUT_DLG: 
return — (initAboutDlg() ); 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
} 


f 
// 初始 化 关于 对 话 框 
private Dialog initAboutDlg() { 
// TODO Auto-generated method stub 
mAboutDlg = new Dialog (this); 
mAboutDlg.setContentView (R.layout.about view); 
mAboutDlg.setTitle ("About JournalBook"); 
return (mAboutDlg); 
1 
GOverride 
public boolean onOptionsItemSelected (MenuItem item) { 
switch(item.getItemId() ) { 
case R.id.MI ABOUT: {// 显示 关于 对 话 框 
doAbout () 7 
break; 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 


return (super.onOptionsItemSelected (item) ); 
} 


通过 以 上 代码 ， 可 以 了 解 使 用 关于 对 话 框 的 两 个 时 间 : 初始 化 和 显示 调 
通过 菜单 项 进行 调用 ， 调 


。 初 始 化 时 所 做 的 “工作 ”包括 : 构造 对 话 框 对 象 实例 、 设 置 内 容 视图 
代码 中 只 需 通 过 本 Activity 组 件 的 “showDialog” 方 法 就 可 以 显示 对 话 框 了 。 


和 设置 顶部 ， 总 之 都 是 为 显示 做 准备 。 对 话 框 的 显示 是 


通过 选择 程序 功能 结构 中 的 退出 菜单 项 (“Quit”) 所 启动 的 对 话 框 界 面 ， 如 图 3-18 所 示 。 


Exit program? 


图 3-18 退出 对 话 框 


由 于 退出 对 话 框 的 用 法 和 关于 对 话 框 是 相同 的 ， 所 以 主要 介绍 退出 对 话 框 的 初始 化 过 程 ， 其 中 代码 如 下 : 


private Dialog initQuitDlg() { 
AlertDialog.Builder builder = new AlertDialog.Builder (this) ; 
// 提示 信息 
builder.setMessage ("Exit program") ; 
builder.setCancelable (false) ; 
// "Yes" 按 钮 
builder.setPositiveButton("Yes", new DialogInterface.OnClickListener() { 
GOverride 
public void onClick(DialogInterface dialog, int which) ( 
// TODO Auto-generated method stub 
SQLiteDBJournalBookAct.this.finish(); 


} 
1; 
// "No" 按 钮 


builder.setNegativeButton ("No", new DialogInterface.OnClickListener() { 
GOverride 
public void onClick(DialogInterface dialog, int which) ( 
// TODO Auto-generated method stub 
dialog.cancel(); 
l 
n; 
mQuitDlg = builder.create(); 
return (mQuitDlg); 


在 以 上 代码 中 ， 通 过 提示 对 话 框 的 构建 类 (Bulider) 为 该 对 话 框 添加 了 两 个 按钮 组 件 ， 用 于 确认 用 户 是 否 退出 系统 。 
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第 4 章 Android 系统 移植 


4.1 Android 结 构 介绍 


在 第 1 章 已 经 介绍 了 Android 体 系 结构 ， 此 处 不 再 袭 述 。 根 据 Android 系 统 体系 结构 图 可 知 ，Android 软 件 层次 结构 自 下 而 上 分 为 以 下 四 个 层次 : 操作 系统 层 (OS) 、 各 种 函 式 库 (Libraries) 、 
Android 运 行 时 (RunTime) 和 应 用 程序 框架 (Application Framework) 以 及 应 用 程序 (Applications) ， 其 中 操作 系统 采用 的 是 Linux。 下 面 对 操作 系统 层 (OS) 进 行 介 绍 。 


Android 系 统 中 的 内 核 结构 和 标准 的 Linux 2.6 内 核 基 本 是 相同 的 ， 如 安全 性 、 内 存 管理 、 进 程 管理 、 网 络 协议 栈 和 驱动 模型 等 都 基本 上 是 相同 的 。 因 为 Android 系 统 通常 用 于 移动 设备 ， 所 以 Android 系 
统 在 Linux 2.6 内 核 基础 上 增加 了 自己 本 地 的 内 容 。Android 系 统 相 对 标准 的 Linux 内 核 ， 增 加 的 主要 是 一 些 驱动 程序 ， 如 共享 内 存 、 进 程 间 通 信 等 设备 驱动 程序 。Android 系 统 主要 用 到 的 驱动 程序 如 下 : 


- 显示 驱动 (Display Driver) : 基于 Linux 的 帧 缓冲 (Frame Buffer) 驱动 。 

“ 键盘 驱动 (KeyBoard Driver) : 作为 输入 设备 的 键盘 驱动 。 

“ 触 控 屏 幕 驱动 (TouchScreen) : 作为 输入 设备 的 触 控 屏 幕 驱动 。 

:Flash 驱动 (Flash Memory Driver) : 基于 MTD 的 Flash 驱 动 。 

- 照相 机 驱动 (Camera Driver) : 基于 Linux 的 v412 (Video for Linux) 驱动 。 

- 音频 驱动 (AudioDriver) : 基于 ALSA (Advanced Linux SoundArchitecture ， 高 级 Linux 声 音 体 系 ) 框架 驱动 。 
© WiFi 驱动: 基于 IEEE 802.11 标 准 的 驱动 。 

+ Power Management (电源 管理 ) 。 


- 蓝牙 驱动 (Bluetooth Driver): 基于 IEEE 802.15.1 标 准 的 无 线 传 输 技术 。 


由 于 Android 系 统 是 开源 的 ， 因 此 它 的 内 核 源 代码 也 是 开放 源 代码 ， 其 中 内 核 程序 代码 包括 用 于 模拟 器 的 公共 程序 代码 、MSM 平 台 内 核 源 代码 和 Omap 平 台 的 内 核 源 代码 ， 它 们 在 Android 系 统 开 源 代 
码 中 的 名 称 分 别 为 kernel/common.git、kernel/msm.git 和 kernel/omap.git。 可 以 使 用 git 工 具 从 Android 系 统 的 开源 工程 网 站 上 获取 内 核 源 代 码 ， 方 法 如 下 所 示 : 


+ 获取 goldfish 内 核 源 代码 : 


git clone git://android.git.kernel.org/kernel/common.git 


` 获取 MSM 内 核 源 代码 : 


git clone git://android.git.kernel.org/kernel/msm.git 


“ 获取 Omap 内 核 源 代码 : 


git clone git://android.git.kernel.org/kernel/omap.git 


本 书 中 使 用 的 是 Samsung 公 司 提供 的 Linux 2.6.35 内 核 ， 是 完全 针对 Samsung 公 司 开发 的 ARM Cortex-A8 微 处 理 器 开发 的 。DMA-210XP 就 是 一 款 采 用 ARMCortex-A8 微 处 理 器 开发 的 实验 平台 。 


第 4 章 ” Android 系统 移植 


4.1 Android 结 构 介绍 


在 第 1 章 已 经 介绍 了 Android 体 系 结构 ， 此 处 不 再 袭 述 。 根 据 Android 系 统 体系 结构 图 可 知 ，Android 软 件 层 次 结构 自 下 而 上 分 为 以 下 四 个 层次 : 操作 系统 层 (OS) 、 各 种 函 式 库 (Libraries) 、 
Android 运 行 时 (RunTime) 和 应 用 程序 框架 (Application Framework) 以 及 应 用 程序 (Applications) ， 其 中 操作 系统 采用 的 是 Linux。 下 面 对 操作 系统 层 (OS) 进 行 介 绍 。 


Android 系 统 中 的 内 核 结构 和 标准 的 Linux 2.6 内 核 基 本 是 相同 的 ， 如 安全 性 、 内 存 管理 、 进 程 管理 、 网 络 协议 栈 和 驱动 模型 等 都 基本 上 是 相同 的 。 因 为 Android 系 统 通常 用 于 移动 设备 ， 所 以 Android 系 
统 在 Linux 2.6 内 核 基础 上 增加 了 自己 本 地 的 内 容 。Android 系 统 相对 标准 的 Linux 内 核 ， 增 加 的 主要 是 一 些 驱 动 程 序 ， 如 共享 内 存 、 进 程 间 通信 等 设备 驱动 程序 。Android 系 统 主 要 用 到 的 驱动 程序 如 下 : 
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“ 显示 驱动 (Display Driver) : 基于 Linux 的 帧 缓冲 (Frame Buffer) 驱动 。 

: 键盘 驱动 (KeyBoard Driver) : 作为 输入 设备 的 键盘 驱动 。 

- 触 控 屏幕 驱动 (TouchScreen) : 作为 输入 设备 的 触 控 屏幕 驱动 。 

“ Flash3 4j. (Flash Memory Driver) : 基于 MTD 的 Flash 驱 动 。 

+ 照相 机 驱动 (Camera Driver) : 基于 Linux 的 v412 (Video for Linux) 驱动 。 

- 音频 驱动 (AudioDriver) : 基于 ALSA (Advanced Linux SoundArchitecture ， 高 级 Linux 声 音 体 系 ) 框架 驱动 。 
.Wi-Fi 驱动 : 基于 IEEE 802.11 标 准 的 驱动 。 

+ Power Management (电源 管理 ) 。 


- 蓝牙 驱动 (Bluetooth Driver): 基于 IEEE 802.15.1 标 准 的 无 线 传 输 技术 。 


由 于 Android 系 统 是 开源 的 ， 因 此 它 的 内 核 源 代码 也 是 开放 源 代码 ， 其 中 内 核 程序 代码 包括 用 于 模拟 器 的 公共 程序 代码 、MSM 平 台 内 核 源 代码 和 Omap 平 台 的 内 核 源 代 码 ， 它 们 在 Android 系 统 开源 代 
码 中 的 名 称 分 别 为 kernel/common.git、kernel/msm.git 和 kernel/omap.git。 可 以 使 用 git 工 具 从 Android 系 统 的 开源 工程 网 站 上 获取 内 核 源 代 码 ， 方 法 如 下 所 示 : 


+ 获取 goldfish 内 核 源 代码 : 


git clone git://android.git.kernel.org/kernel/common.git 


C 获取 MSM 内 核 源 代码 : 


git clone git://android.git.kernel.org/kernel/msm.git 


“ 获取 Omap 内 核 源 代码 : 


git clone git://android.git.kernel.org/kernel/omap.git 


本 书 中 使 用 的 是 samsung 公 司 提供 的 Linux 2.6.35 内 核 ， 是 完全 针对 Samsung 公 司 开发 的 ARM Cortex-A8 微 处 理 器 开发 的 。DMA-210XP 就 是 一 款 采 用 ARMCortex-A8 微 处 理 器 开发 的 实验 平台 。 


4.2 Android 内 核 结构 和 设备 驱动 


Android 的 内 核 结构 和 标准 的 Linux 内 核 并 没有 多 大 区 别 ， 基 本 保持 了 原 Linux 内 核 开源 区 所 提供 的 基本 架构 ， 所 以 可 以 根据 Linux 内 核 源 代码 去 读 写 Android 内 核 源 代码 。 下 面 对 Android 系 统 的 内 核 结 
构 和 一 些 主要 驱动 设备 进行 介绍 。 


4.2.1 Android 内 核 源 代码 结构 


因为 Android 的 内 核 系统 服务 依赖 于 Linux 2.6 内 核 ， 所 以 Android 的 内 核 程序 代码 在 结构 上 与 普通 Linux 内 核 是 一 样 的 ， 包 含 了 系统 内 核 支配 的 各 个 文件 目录 ， 表 4-1 描 述 了 内 核 各 目录 的 功能 。 


ЖАЛ Linux 内 核 架 构 描 述 


BR 名 ж ж 
与 体系 结构 相关 的 程序 代码 ， 对 于 每 个 架构 的 CPU，arch 目录 下 都 有 一 个 对 应 的 子 目录 ， 


ка 如 arch/arm, arch/x86 等 
block 块 设备 的 通用 函数 
crypto 常用 加 密 和 散 列 算法 (如 AES 等 ) 还 有 一 些 压缩 和 CRC 校 验算 法 
diven 所 有 的 设备 驱动 ， 包 括 字符 设备 驱动 ( /driver/char)、 块 设备 驱动 (/driverblock)、 网 络 设备 
驱动 (/driver/net) 以 及 Flash 驱动 (/driver/mtd) 
ë Linux 支持 的 文件 系统 程序 代码 ， 每 一 个 子 目 录 下 对 应 一 种 文件 系统 ， 如 /fs/jffs2、/fs/yaff2、 
/fs/ext3 、/fs/nfs 等 
a 包含 内 核 各 种 系统 的 头 文件 ， 在 配置 内 核 后 ，include/arm 是 某 个 include/asm-xxx/ 的 连接 ， 
如 include/asm-arm 
内 核 的 初始 化 程序 代码 ， 其 中 main.c 文件 中 的 start kernel 函数 是 内 核 引 导 后 执行 的 第 一 个 
函数 
ipc 进程 间 通 信 的 程序 代码 
kernel 内 核 管理 的 内 核 程 序 代 码 ， 与 处 理 器 相关 的 程序 代码 位 于 arch/*/kernel/ 目录 下 
lib 内 核 用 到 的 一 些 库 函 数 程序 代码 ， 如 crc32.c。 与 处 理 器 相关 的 函数 库 程序 代码 位 于 arch/*/ 
lib/ 目录 下 
mm 内 存 管 理 程序 代码 ， 与 处 理 器 相关 的 内 存 管 理 程序 代码 位 于 arch/*/mm/ 目录 下 
net 网 络 支 持 程序 代码 ， 每 个 子 目 录 对 应 于 网 络 的 一 个 方面 
Security 安全 、 密 钥 相 关 的 程序 代码 
CHE) 
BR 名 ж x 
sound 音频 设备 的 驱动 
- 用 来 制作 一 个 压缩 的 cpio 文件 : initrd 的 镜像 ， 它 可 以 作为 内 核 局 动 后 挂 接 的 第 一 个 文件 系 
统 (一 般 用 不 到 ) 
Documentation 文件 
scripts 用 于 配置 、 编 译 内 核 的 指令 文件 
firmware ERENT HICH ЕЮ, Android 系统 用 到 
virt Кут ЖЮК, Android 系统 用 到 


从 上 边 Android 内 核 架构 目录 中 可 以 看 出 ， 与 普通 的 Linux 内 核 相 比较 ，Android 系 统 要 求 内 核 必 须 支 持 一 些 Android 系 统 特 定 的 功能 ， 例 如 无 线 上 网 、 电 源 管理 等 。 经 过 与 普通 的 Linux 内 核 比 较 ， 发 现 
其 主要 增加 了 以 下 几 方 面 的 内 容 : 


- 增加 了 与 Android 的 相关 驱动 ， 相 应 目录 为 : kernel/drivers/Android， 其 中 包括 电源 管理 (power) 、IPC 系 统 (Binder) 、 日 志 系统 (Logger) . APH (Alarm) 、 内 存 控制 台 (Ram console) 和 时 钟 
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空 制 的 gbio (Timed_gpio) 。 
- 增加 了 支持 yaffs2 的 Flash 文 件 系统 ， 相 应 增加 的 目录 为 : kernel/fs/yaffs2， 实 际 上 ，Android 的 原始 程序 代码 经 过 编译 后 生成 的 system.img 和 ramdisk.img 文 件 就 是 yaffs2 格 式 的 包 。 


“ 增加 了 一 种 新 的 共享 内 存 处 理 方式 ，Ashmem 的 含义 是 匿名 共享 内 存 (Anonymous Shared Memory) ， 通 过 这 种 内 核 机 制 ， 可 以 为 用 户 空间 程序 增加 一 种 新 的 共享 内 存 处 理 方式 ， 类 似 malloc 的 功能 。 相 
应 增加 的 文件 为 : kernel/mm/ashmem.c。 设 备 节点 名 称 为 : /dev/ashmem。 


+ 增加 了 进程 通信 机 制 Binder，Android 的 Binder 了 驱动 程序 为 用 户 层 程序 提供 了 IPC (进程 间 通 信 ) 支持 。Android 整 个 系统 的 执行 都 依赖 Binder 了 驱动。Binder 设 备 节点 名 称 为 /dev/binder。 相 应 增加 的 文件 
为 : kernel/drivers/staging/android/binder.c 


“日 志 系 统 (Logger) ，Logger 了 驱动 程序 是 为 用 户 层 程 序 提供 日 志 支 持 。 只 作为 一 个 工具 使 用 。 相 应 增加 文件 为 : kernel/drivers/staging/android/logger.c。 


NAE EIE (Ram Console) ，Ram_Console 提 供 一 种 可 以 辅助 除 错 的 内 核 机 制 。 实 现 的 方式 是 利用 一 块 内 存 构建 一 个 虚拟 的 console 设 备 。 当 内 核 中 输出 打印 信息 的 时 候 ， 除 错 信 息 将 同时 输出 到 这 
个 console 设 备 中 。 


+ Ram_Console 与 用 户 空间 的 接口 是 /proc 文 件 系统 ， 在 proc 中 使 用 的 名 称 为 kmsg， 它 表示 kernel 最 后 输出 的 信息 。 相 应 增加 的 文件 为 : kernel/dtivers/staging/android/ram_console.c。 


- Timed Gpio 启 动 程序 ，Time Gpio 实 际 上 是 一 个 基于 Time Output 框 架 的 驱动 。 用 于 定时 控制 相应 的 GPIO。 调 用 timed output 框 架 ， 在 enable 和 get_time 函 数 中 调用 gpio 子 系统 的 内 容 实 现 相应 的 功能 。 在 
DMA-210XP 实 验 平台 上 Time Gpio 用 于 来 电 振动 功能 。 相 应 增加 的 文件 为 : kernel/drivers/staging/android/vibrator.c。 


:Alarm 驱动 ，Alarm 驱 动 为 用 户 空间 提供 一 个 时 钟 的 接口 。 它 和 RTC 系 统 紧 密 相关 ， 起 到 封装 的 作用 。 同 时 使 用 了 Android 系 统 的 wake_lock 功 能 。 相 应 增加 的 文件 为 : kernel/drivers/rtc/alarm.c o 
+ ADB Garget 驱 动 ，ADB Gatget 驱 动 就 是 一 种 USB Garget 了 驱动。 在 Android 系 统 中 用 来 作为 adb 除 错 功 能 和 内 存 功能 ， 并 提供 ADB 接 口 ， 方 便 用 户 在 线 除 错 。 


+ Android 内 核 增 加 了 对 EABI(Embedded Application Binary Interface) 的 支持 ， 这 让 软件 开发 者 可 以 混合 使 用 EABI 兼 容 的 不 同 厂商 之 间 的 二 进 制 库 ， 即 只 要 它们 是 EABI 兼 容 的 ， 并 且 开 发 者 的 软件 也 是 用 
EABI 兼 容 的 编译 器 编译 的 ， 就 可 以 一 起 使 用 。 


4.2.2 Android 常 用 设备 驱动 
Android 系 统 不 仅 有 自己 的 本 地 设备 驱动 ， 还 可 以 使 用 Linux 中 一 些 标准 的 设备 驱动 ， 如 Framebuffer 驱 动 、 键 盘 驱动 、NAND FIASH 驱 动 等 。 
1.Framebuffer 驱 动 


在 Linux 系 统 中 ，Framebuffer 驱 动 是 标准 的 显示 设备 驱动 。 相 应 驱动 文件 的 路 径 为 kernel/driver/video/Samsung。 在 配置 Linux 系 统 时 ，Framebuffer 驱 动 的 配置 选项 是 : “Driver 
Drivers" — "Graphics supports" 一 “Support for framebuffer devices”， 如 图 4-1 所 示 。 
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图 4-1 Framebuffer 驱 动 的 配置 
具体 的 Framebuffer 驱 动 由 每 个 平台 决定 。 不 同 平台 ， 不 同 的 实现 设备 ， 对 应 的 Framebuffer 驱 动 是 不 同 的 。 


Android 系 统 对 Framebuffer 驱 动 的 封装 和 Linux 有 所 不 同 。Linux 系 统 对 Framebuffer 驱 动 设备 封装 为 /dev/fb*， 而 Android 系 统 则 封装 为 /dev/graphic/fb*。 但 这 两 种 系统 对 Framebuffer 驱 动 的 使 用 
方式 都 是 标准 的 。 通 过 调用 Framebuffer 驱 动 的 标准 接口 ， 实 现 设 备 的 显示 功能 。 


2 键盘 驱动 
为 了 满足 Android 系 统 上 层 UI 的 需要 ，DMA-210XP 实 验 平台 的 技 键 被 设计 成 Event 输 入 设备 ， 驱 动 在 内 核 中 的 相关 路 径 如 下 : 


Kernel/driver/input/keyboard/s3c-keypad.c 
Kernel/driver/input/keyboard/s3c-keypad.h 


按键 驱动 在 文件 系统 中 的 设备 节点 为 : /dev/input/eventX，X 可 以 为 0、1、2， 具 体 数值 要 根据 系统 输入 设备 数 而 定 。 
在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 键盘 驱动 程序 的 配置 ， 配 置 选项 为 : “Driver Drivers" — "Input devices support” 一 “Keyboards”， 如 图 4-2 所 示 。 


Android 在 GUI 系统 中 打开 Event 输 入 驱动 的 设备 节点 ， 将 按键 信息 转换 成 GUI 系统 的 功能 键 值 ， 从 而 实现 各 种 操作 。 这 种 转换 是 通过 映像 表 完 成 的 ， 如 s3c-keypad.kI 文 件 。Android 系 统 在 启动 的 过 程 
中 ， 会 回去 读 取 这 个 映像 表 ， 从 而 实现 键 值 转换 。 


3. 触 控 屏 幕 驱动 
和 按键 一 样 ， 触 控 屏 幕 也 属于 Event 输 入 设备 。 也 是 被 Android 系 统 作为 标准 的 输入 设备 来 使 用 的 。 触 控 屏 幕 驱 动 程序 在 内 核 中 的 相关 路 径 如 下 : 
电容 屏幕 驱动 : Kernel/driver/input/touchscreen/touch_hf704f.c 
- 电阻 屏幕 驱动 : Kernel/driver/input/touchscreen/ts-s3c.c 
触 控 屏幕 驱动 在 文件 系统 中 的 设备 节点 为 : /dev/input/eventX，X 的 具体 数值 要 根据 系统 输入 设备 数 而 定 。 


在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 触 控 屏 幕 驱动 程序 的 配置 ， 配 置 选项 为 : “Driver Drivers" — "Input devices support” 一 “Touchscreens”， 如 图 4-3 所 示 。 


图 4-2 ”按键 驱动 配置 
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EA ” 触 控 屏 幕 驱动 配置 


DMA-210XP 实 验 平台 标 配 的 是 7 寸 电容 触 控 屏 幕 ， 可 以 支持 四 个 点 同时 相应 触 控 。 和 键盘 驱动 程序 不 同 的 是 ，Android 在 GUI 系统 中 直接 打开 触 控 屏幕 驱动 的 设备 节点 。 驱 动 直接 判断 触 控 屏幕 的 响应 


事件 ， 从 而 实现 各 种 操作 。 与 此 类 似 的 还 有 鼠标 功能 。 
4.EAC 音 效 驱 动 


音效 设备 是 Android 系 统 的 一 个 重要 组 成 部 分 ， 在 Linux 系 统 中 ， 通 常 使 用 的 有 OSSs 音 效 驱 动 和 ALSA 音 效 驱动 。 这 里 移植 了 一 个 EAC 音 效 驱动 。 与 以 上 两 种 类 型 驱动 不 同 的 是 ，EAC 音 效 驱动 是 一 个 非 标 
准 的 MISC 驱 动 ， 通 过 读 写 来 实现 音效 的 播放 与 录音 。 在 用 户 空间 的 设备 节点 为 /deweac。 驱 动 程序 在 内 核 中 的 相关 路 径 如 下 : 


Kernel/sound/soc/wm9713/ 


EAC 音 效 驱 动 在 内 核 进行 make menuconfig 配 置 时 ， 配 置 选 项 为 : “Driver Drivers" > "Sound card support" — "Advanced Linux Sound Architecture" — “ALSA for SoC audio 
support”， 如 图 4-4 所 示 。 
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图 4-4 ”EAC 音效 驱动 配置 
在 Android 系 统 中 ， 通 过 向 EAC 音 效 驱动 的 ioctl 函 数 发 送 相应 的 指令 ， 以 获取 声音 的 输出 流 和 输入 流 。 和 ALSA 音 效 驱 动 相 比 ， 操 作 更 加 简单 。 
5.Camera 驱 动 


在 Linux 系 统 中 ，Camera 驱 动 一 般 归 类 为 V4L2 驱 动 ， 通 过 IIC 来 传输 资料 。DMA-210XP 实 验 平台 增加 了 一 台 型 号 为 OV3640 的 摄影 机 。 其 驱动 同样 采用 V4L2 架 构 。OV3640 的 驱动 在 内 核 中 的 相关 路 径 
如 下 : 


Kernel/drivers/media/video/ov3640.c 
Kernel /drivers/media/video/ov3640.h 


V4L2 驱 动 的 video 的 设备 节点 路 径 如 下 : 


/dev/videoX 


其 中 X 可 取 0, 1, 2, 3, 4, ... 


在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 OV3640 驱 动 程序 的 配置 ， 配 置 选项 为 : “Driver Drivers" > “Multimedia support" — “Video capture adapters”， 如 图 4-5 所 


Android 系 统 中 Camera 作 为 一 个 重要 的 工具 ， 不 仅 具 有 拍照 的 功能 ， 还 可 以 录像 。 基 于 DMA-210XP 实 验 平台 的 限制 ， 没 有 设置 前 置 摄影 机 ， 所 以 暂时 还 无 法 实现 视频 聊天 的 功能 。 另 外 ，DMA- 
210XP 实 验 平台 支持 Camera 的 热 插入 功能 。 


6.DM9000 网 络 驱动 


大 家 都 知道 ，Android 系 统 本 身 并 不 支持 有 线 网 络 。 大 多 是 通过 无 线 Wi-Fi 或 者 3G 实 现 网 络 功能 的 。 但 作为 实验 平台 ， 为 了 更 加 丰富 使 用 者 的 学 习 环境 。 在 DMA-210XP 实 验 平台 上 增加 了 一 个 DM9000 
网 络 芯片 。 可 以 通过 设置 IP 或 者 自动 获取 IP 来 实现 上 网 功能 。DM9000 网 络 的 驱动 在 内 核 中 的 相关 路 径 如 下 : 


Kernel/drivers/net/dm9000.c 
Kernel/drivers/net/dm9000.h 


在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 DM9000 网 络 驱动 程序 的 配置 ， 配 置 选项 为 : “Driver Drivers" — "Network device support" — "Ethernet(10 or 100Mbit)" , 
如 图 4-6 所 示 。 
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图 4-5 ”Camera 驱 动 配置 


图 4-6 DM9000 网 络 驱 动 配置 


在 DMA-210XP 实 验 平 台 上 ， 设 置 通过 DM9000 网 络 上 网 的 方法 是 : 在 Android 系 统 成 功 启动 之 后 ， 进 入 主页 面 ， 单 击 “ 设 置 ” 一 “无 线 网 络 ”一 “Ethernet Setting”。 进 入 Ethernet Setting 接 口 就 
可 以 设置 了 。 


注意 : 在 Android 源 代码 中 是 没有 Ethernet Setting 这 一 部 分 程序 代码 的 ， 是 该 平台 根据 需要 移植 进去 的 。 
7.SDVTF 存 储 卡 驱动 


Android 系 统 中 存储 卡 是 不 可 或 缺 的 一 部 分 ， 系 统 更 新 、 文 件 保存 与 读 取 、 图 片 放置 位 置 、 音 乐 播放 文件 等 都 离 不 开 存 储 卡 。 熟 悉 Android 系 统 的 读者 应 该 知道 ，Android 系 统 2.2 之 后 的 版 本 是 支持 应 
用 程序 直接 安装 在 存储 卡 上 的 。 


DMA-210XP 实 验 平台 设置 了 三 张 存储 卡 ， 分 别 是 一 个 SD 卡 座 ， 一 个 可 插 拔 式 TF 卡 座 和 一 个 固定 TF 卡 座 。Android 系 统 会 优先 识别 先 插 入 的 卡 。 存 储 卡 的 驱动 在 内 核 中 的 相关 路 径 如 下 : 


Kernel/drivers/mmc/host/sdhci.c 
Kernel /drivers/mmc/host/sdhci-s3c.c 


存储 卡 驱动 在 内 核 进行 make menuconfig 配 置 时 ， 配 置 选项 为 : "DriverDrivers" > "MMC/SD/SDIO card support”， 如 图 4-7 所 示 。 
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图 4-7 存储 卡 驱 动 配置 


注意 : Android 系 统 对 记忆 卡 读 取 方 面 没有 其 他 的 Linux 系 统 强 。 所 以 最 好 不 要 随便 插 拔 记忆 卡 。 尤 其 Android 2.3 之 后 ， 系 统 去 掉 了 印 除 记忆 卡 这 一 项 操作 ， 目 的 就 是 防止 拔 掉 记 忆 卡 。 因 为 有 些 程序 
是 安装 在 记忆 卡 中 的 ， 随 便 去 掉 记忆 卡 很 容易 导致 系统 崩溃 。 


8.RTC 驱 动 


RTC (Real-Time Clock) 是 实时 时 钟 的 意思 ， 它 的 主要 作用 就 是 提供 稳定 的 时 钟 信号 给 后 续 电 路 使 用 ， 在 系统 断 电 之 后 ， 会 自动 保存 系统 时 钟 设置 。 主 要 功能 有 : 时钟、 日历、 闹钟、 周期 性 中 断 输 
出 。 


DMA-210XP 实 验 平台 RTC 驱 动 在 内 核 中 的 相关 路 径 如 下 : 


Kernel/arch/arm/mach-smdkv210/smdkc110-rtc.c 


RTC 驱 动 在 用 户 空间 的 设备 节点 为 /dev/rtc0。 


在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 RTC 驱 动 程序 的 配置 ， 配 置 选 项 为 : “Driver Drivers" — "Real Time Clock”， 如 图 4-8 所 示 。 
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94-8 ” RTC 驱动 配置 


注意 : Android 系 统 并 没有 在 用 户 空间 使 用 RTC 设 备 ， 而 是 通过 内 核 空间 的 Alarm 设 备 对 其 进行 控制 。 


9.MTD 驱 动 


MTD (Memory Technology Devices) 称 为 内 存 技术 设备 ， 是 用 于 访问 Memory 设 备 (Rom. Flash) 的 Linux 的 子 系统 。 在 DMA-210XP 实 验 平台 中 ，MTD 主 要 用 于 NAND FIASH 驱 动 。 


MTD 的 所 有 源 代码 在 /drivers/mtd 子 目录 下 ，NAND FIASH 的 驱动 则 位 于 /drivers/mtd/nand 子 目录 下 ， 相 关 路 径 如 下 : 


Kernel/drivers/mtd/ 
Kernel/drivers/mtd/nand/s3c nand.c 


MTD 设 备 包括 块 设备 ( 主 设备 号 31， 设 备 节点 为 /dewblock/mtdblockX) 和 字符 设备 (设备 号 90， 设 备 节点 为 /dev/mtdX) 。 通 过 访问 设备 节点 即 可 访问 MTD 字 符 设 备 和 块 设备 ， 其 中 MTD 字 符 设 
备 的 定义 在 mtdchar.c 中 实现 ， 它 是 通过 注册 一 系列 file operation 函 数 (lseek、open、close、read、write) 实现 的 。MTD 块 设备 则 是 定义 了 一 个 描述 MTD 块 设备 的 结构 mtdblk_dev， 并 声明 了 一 个 名 
为 mtdblks 的 指针 数组 ， 这 个 数组 中 的 每 一 个 mtdblk_dev 与 mtd_table 中 的 每 一 个 mtd_info 一 一 对 应 。 


MTD 驱 动 通常 不 在 用 户 空间 之 间 调 用 ， 而 是 用 于 构建 文件 系统 。 内 核 启动 后 ， 通 过 mount 命 令 可 以 将 NAND FIASH 中 的 各 分 区 作为 文件 系统 挂 载 到 mountpoint 上 。 


在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 MTD 驱 动 程序 的 配置 ， 配 置 选项 为 : “DriverDrivers” 一 “Memory technology Device(MTD)support”， 如 图 4-9 所 示 。 


图 4-9 MTD 驱 动 配置 


在 编译 Android 内 核 时 ， 通 执行 make menuconfig 命 令 ， 进 行 NAND FIASH 的 配置 ， 配 置 选项 为 : “Driver Drivers" ^ “Memory technology Device(MTD)support" — “NAND Device 
Support”， 如 图 4-10 所 示 。 
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4-10 NAND FIASH 了 驱动 配置 


DMA-210XP 实 验 平台 在 MTD 被 分 成 了 7 个 分 区 ， 分 别 为 : misc、recovery、kernel、ramdisk、system、cache 和 userdata。 其 中 kernel、ramdisk 和 system 这 三 个 分 区 是 系统 启动 必须 挂 载 的 ， 否 则 
系统 无 法 启动 。 


10. 蓝 牙 驱动 
在 Android 系 统 中 ， 整 个 蓝牙 系统 由 驱动 层 、 协 议 层 、 适 配 层 和 java 框 架 层 组 成 。 在 内 核 部 分 ， 蓝 牙 包括 了 驱动 和 协议 层 两 部 分 。 下 面 对 这 两 部 分 进行 介绍 。 


与 硬件 衔接 最 紧密 的 就 是 驱动 ， 蓝 牙 设备 通常 通过 USB、SDIO 和 UART 接 口 进行 连接 。 其 中 USB 和 SDIO 通 常 采用 标准 的 硬件 接口 和 驱动 。UART 则 需要 使 用 芯片 上 的 高 速 串 行 口才 能 承载 蓝牙 协议 中 需 
要 高 速 传输 的 部 分 。 这 部 分 的 程序 代码 主要 分 布 在 内 核 driver/usb 和 driver/serial 路 径 中 。 其 中 蓝牙 的 驱动 在 内 核 的 路 径 如 下 : 


Kernel/drivers/bluetooth/* 


蓝牙 驱动 在 内 核 进行 make menuconfig 配 置 时 ， 配 置 选项 为 : "Networkingsupport" — "Bluetooth subsystem support" — "Bluetooth device drivers”， 如 图 4-11 所 示 。 


图 4-11 ”蓝牙 的 驱动 配置 


对 于 使 用 USB、SDIO 和 UART 中 的 哪 一 个 接口 ， 可 根据 硬件 来 选择 ， 或 者 也 可 以 都 选 上 。 其 中 hci_vhci.c 是 蓝牙 虚拟 主 控制 器 驱动 ，btusb.c 是 USB 接 口 的 主 控制 器 驱动 。Btsdio.c 是 SDIO 接 口 的 主 控制 
器 驱动 。 蓝 牙 协 议 栈 被 封装 成 BlueZ 文 件 ， 已 经 包含 在 Linux 2.6 内 核 程序 代码 中 。 作 为 Linux 的 标准 蓝牙 实现 ， 蓝 牙 协议 层 在 内 核 中 的 路 径 如 下 : 


Kernel/net/bluetooth/* 


在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 协议 层 程序 的 配置 ， 配 置 选 项 为 : "Networking support" — "Bluetooth subsystem support”， 如 图 4-12 所 示 。 
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A412 ”协议 层 程序 配置 
协议 层 列 出 了 各 种 协议 支持 ， 其 中 最 重要 的 是 HCIP、L2CAP、SCO、RFCOMM 和 BNEP。 一 般 情 况 下 全 部 开启 就 可 以 了 。 


Android 系 统 使 用 了 标准 的 Linux Rfkill 接 口 对 蓝牙 芯片 进行 电源 管理 ， 所 以 在 内 核 中 对 蓝牙 进行 配置 时 ， 要 加 上 Rfkill 这 部 分 ， 配 置 选 项 为 : "Networking support" 一 “RF switch subsystem 
support”， 如 图 4-13 所 示 。 
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在 关 掉 蓝 牙 功 能 之 后 ， 蓝 牙 芯 片 即 可 自动 进入 低 功 耗 模块 。 而 在 开启 蓝牙 功能 时 ， 则 需要 再 次 进行 电源 开关 操作 。 


11.WLAN 驱 动 

Wi-Fi 这 个 术语 是 指 无 线 保 真 (Wireless Fidelity) ， 是 Wi-Fi 联 盟 制造 商 的 商标 ， 可 作为 产品 的 品牌 认证 ， 是 一 个 创建 于 IEEE 802.11 标 准 的 无 线 局 域 网 络 (WLAN) 设备 。 通 常 WLAN 的 硬 设备 是 Wi-Fi 
芯片 ，Wi-Fi 的 功能 也 就 被 整合 在 该 芯片 中 。 相 应 的 底层 驱动 一 般 都 有 芯片 厂商 提供 。 

Android 系 统 的 Wi-Fi 主 要 包括 Linux 内 核 中 的 驱动 和 协议 、Wi-Fi 本 地 实现 和 JAVA 框架 层 。 这 里 对 Linux 内 核 中 的 驱动 和 协议 进行 介绍 。 在 Android 系 统 中 ，WLAN 设 备 被 作为 网 络 设备 ， 使 用 网 络 接 
口 ， 设 备 接口 名 字 通 常 是 wlan0， 在 Linux 内 核 中 驱动 的 路 径 如 下 : 


Kernel/drivers/net/wireless/ 


在 编译 Android 内 核 时 ， 通 过 执行 make menuconfig 命 令 ， 进 行 驱动 程序 的 配置 ， 配 置 选项 为 : “Driver Drivers" > "Network devices support" — "Wireless LAN”， 如 图 4-14 所 示 。 
Wi-Fi 驱 动 部 分 的 文件 比较 多 ,包含 了 不 同 Wi-Fi 设 备 的 驱动 ， 如 USB 接 口 和 SDIO 接 口 的 驱动 。 通 常 还 需要 设置 配置 文件 (firmware) 的 路 径 。 


在 Linux 内 核 中 ，Wi-Fi 协 议 部 分 的 源 代 码 路 径 如 下 : 


Kernel/net/wireless/ 


Wi-Fi 协 议 部 分 在 内 核 进行 make menuconfig 配 置 时 ， 配 置 选项 为 : "Networking support” 一 “Wireless”， 如 图 4-15 所 示 。 


图 4-14 Wi-Fi 驱 动 配置 


图 4-15 Wi-Fi 协 议 配 置 


Wi-Fi 协 议 部 分 的 内 容 比较 简单 ， 一 般 只 需要 配置 cfg80211 基 本 项 就 可 以 了 。 这 里 “Wireless extensions system files” 选 项 表示 使 用 sysfs 对 无 线 网 络 进行 附加 控制 


由 于 Wi-Fi 的 驱动 大 多 是 由 芯片 厂商 提供 ， 所 以 Wi-Fi 的 驱动 在 Android 系 统 中 一 般 编译 成 内 核 模 块 方式 (ko 文件 ) ， 通 过 应 用 的 开关 键 进行 驱动 的 载 入 和 印 除 。 


43 Android 内 核 基本 配置 


Linux 内 核 的 配置 选项 成 二 上 万 ， 如 果 一 个 一 个 选 配 ， 不 仅 浪 费时 间 ， 而 且 不 能 保证 所 配置 的 选项 能 够 针对 实验 平台 ， 从 而 造成 资源 浪费 。 尤 其 是 Android 内 核 配置 ， 更 值得 开发 者 注意 。 一 般 的 做 法 是 
在 某 个 预 设 配置 文件 的 基础 上 进行 修改 ， 如 内 核 配置 文件 arch/arm/config/dma210xp_android_defconfig。 先 使 用 命令 make smdkv210_android_defconfig 进 行 选 配 ， 然 后 加 以 修改 ， 增 加 一 些 平台 需 
要 的 选项 ， 去 除 一 些 平台 不 需要 的 选项 ， 使 最 终 的 配置 选项 完全 适合 实验 平台 。 


4.3.1 Android 内 核 中 的 Kconfig 文 件 


Kconfig 文 件 是 用 于 内 核 配 置 的 。 它 就 是 内 核 中 各 种 配置 的 源 文 件 。 内 核 的 配置 工具 (menuconfig) 会 读 取 各 个 Kconfig 文 件 ， 根 据 各 个 目录 下 的 Kconfig 文 件 生成 配置 接口 ， 以 方便 开发 人 员 对 内 核 进 行 
配置 ， 最 后 储存 、 退 出 配置 接口 ， 生 成 设 定 文件 .config。 


Kconfig 文 件 的 语法 可 以 参考 内 核 目录 /Documentation/kbuild/kconfig-language.txt 文 件 。 而 在 Kconfig 中 的 几 个 重要 的 条 目 comfig、menu、choice、source 和 comment 是 值得 读者 注意 的 ， 因 
为 它们 会 被 经 常用 到 。 


例如 ， 在 内 核 中 增加 一 个 键盘 (KeyPad) 驱动 配置 选项 ， 那 么 键盘 驱动 要 放 到 哪个 目录 下 呢 ? 根据 内 核 驱动 的 布局 ， 把 键盘 驱动 3c-keypad.c 最 终 放 到 drivers/input/keypad 目 录 下 。 详 细 内 容 请 参考 
4.2.2 节 中 按钮 驱动 程序 部 分 。 


4.3.2 Android 内 核 配置 选项 


下 面 分 四 部 分 介绍 Android 内 核 配 置 选项 ， 首 先 从 整体 介绍 主 菜 单 的 类 别 ， 然 后 分 别 介绍 与 Android 内 核 系 统 密切 相关 的 “System Type”、“Kernel Features” 和 “Device Drivers” 选 项 。 


1.Android 内 核 配 置 的 主 菜单 类 别 


在 Android 内 核 主 菜单 中 ， 开 发 者 可 以 根据 自己 开发 所 需 来 配置 某 个 功能 ， 然 后 根据 其 中 的 各 个 配置 选项 的 说 明 信 息 进行 配置 ， 下 面 简单 地 介绍 一 下 内 核 主 菜单 的 名 称 和 功能 ， 如 表 4-2 所 示 。 


表 4-2 内核 主 菜单 的 名 称 和 功能 


主 菜单 接口 名 称 功能 描述 
常规 设置 ， 如 内 核 版 本 号 、 内 存 页 交换 、 进 程 通 信 等 功能 设置 ， 一 般 选 择 默 
General setup там 
认 配 置 
Enable loadable module support 可 加 载 模块 支持 ， 一 般 只 选择 允许 印 载 模块 功能 即 可 (module unloading) 
块 设备 层 ， 用 于 设置 块 设备 的 一 些 参 数 ， 如 设置 VO 调度 器 ， 一 般 使 用 默 
Enable the block layer рее 
认 设 置 
System Type 系统 类 型 : 选择 CPU 架构 ， 教 学 平台 类 型 和 与 教学 平台 相关 的 配置 选项 
Bus support PCMCIA/CardBus 总 线 支持 ， 对 于 本 书 的 教学 平台 ， 不 用 配置 


用 于 设置 内 核 的 一 些 参 数 ， 例 如 是 否 支 持 内 核 抢占 ， 针 对 Android 内 核 ， 必 
须 增 加 对 ARM EABI 的 支持 


Boot options 系统 启动 参数 ， 例 如 设置 命令 行 参 数 、 串 行 端口 等 
CPU Power Management 系统 CPU 工作 模式 

浮 点 运算 仿真 功能 ， 目 前 Linux 不 支持 硬件 浮 点 运算 功能 ， 因 此 选择 默认 
配置 


Kernel Features 


Floating point emulation 


主 菜单 接口 名 称 功能 描述 
Userspace binary formats 可 执行 文件 格式 ， 一般 都 支持 ELR, aout 格式 
Power management options 电源 管理 选项 
Networking support 网 络 通信 协议 选项 ， 一 般 都 支持 各 种 网 络 功能 ， 包 括 无 线 网 络 通信 协议 
设备 驱动 ， 其 中 几乎 包含 了 Linux 的 所 有 驱动，Android 内 核 特别 增加 了 
Device Drivers “ Android version 1.0 back porting for Android 2.6.29” 这 一 项 ， 以 支持 电源 和 疗 
钟 管理 驱动 


文件 系统 ， 可 以 在 里 面 选择 需要 支持 的 文件 系统 ， 如 cramfs、ext3、Jffs2 和 
Yaffs2， 还 可 以 进行 文件 系统 语言 设置 


File systems 


Kernel hacking 移植 内 核 时 的 各 种 选项 

Security options 安全 选项 ， 一 般 使 用 默认 配置 

Cryptographic API 加 密 选 项 

Library routines 库 子 程序 ， 例 如 CRC32, CRC 等 ， 可 以 根据 需要 选 配 


Save an Alternate Configuration File 保存 配置 选项 ， 一 般 默 认 把 内 核 设 定 文件 保存 在 目前 的 目录 下 的 config 中 


2. “System Type” 选 项 : 系统 类 型 配置 


对 于 ARM 实 验 平台 (在 顶层 Makefile 中 修改 ARCH=arm) ， 执 行 make menuconfig 后 ， 在 配置 接口 内 都 可 以 看 到 “System Type” 配 置 选项 ， 进 入 该 配置 接口 ， 可 以 对 平台 类 型 进行 配置 ， 如 图 4-16 
所 示 。 


在 第 1 行 中 ， 针 对 ARM 的 “System Type” 配置 中 包含 了 很 多 的 平台 类 型 ， 如 Samsung 系 列 的 S3C2440、S3C2443、S3C2412、S3C64XX 和 S5PV210/S5PC110 等 ， 针 对 DMA-210XP 实 验 平台 ， 可 选 
择 Samsung S5PV210/S5PC110, “Board selection (SMDKV210) ”表示 为 选择 CPU 的 类 型 ， 可 根据 平台 需要 自行 选择 ， 这 里 选择 SMDKV210。 而 “(0) S3C UART to use for low-level 
messages" “PAY (0) 表示 选择 串 行 口 0 作 为 除 错 串 行 口 。 


3.“Kernel Features” 选项 : 系统 内 核 参数 配置 


编译 适合 DMA-210 平 台 的 Android 系 统 内 核 时， 特别 选用 与 ARM EABI 兼 容 的 编译 程序 编译 内 核 ， 如 图 4-17 所 示 。 


4. "Device Drivers” WIN: 设备 驱动 


"Device Drivers” 是 内 核 的 一 个 主要 菜单 模块 ， 在 “Device Drivers” 选 项 内 包含 了 Linux 系 统 大 多 数 的 驱动 ， 菜 单 中 各 个 子 菜单 下 的 驱动 与 内 核 源 代码 driver 目 录 下 的 各 个 子 目录 一 一 对 应 ， 可 以 根据 
配置 情况 修改 相应 驱动 ，“Device Drivers” 选 项 如 图 4-18 所 示 。 


[Mu] ANU-has š Memory Management 


4-16 ”系统 类 型 配置 


(Dynamic Ticks) 


图 4-17 ”系统 内 核 参数 配置 


Generic Driver Options 2 
Connector — unified userspace <-> kernelspace linker 
Memory Technology Device [MTD] support  —--- 
Parallel port support  ---- 
Block devices  ---- 
Misc devices  ———- 
ATA/ATAPI/MFM/RLL support (DEPRECATELD) m 
SCSI device support  ---- 
Serial ATA and Parallel АТА drivers  ---- 
Multiple devices driver support [RAID and LYM) ---> 
Network device support  ---- 
ISDN support  ---- 
Telephony support  ---- 
Input device support 
Character devices  ---- 
ШШ mimosa === 
SPI support  ——-- 
BES So. == 
GPIO Support  ---- 
Dallas's i1-wire support  ---- 
Power supply class support  ---- 
Hardware Monitoring support  ---- 
Generic Thermal sysfs driver  ---- 
Watchdog Timer Support  -—--- 
Sonics Silicon Backplane  ---- 
Multifunction device drivers  ---- 
Voltage and Current Regulator Support  -—-- 
Multimedia support ———-> 
Graphics support  ---- 
Sound card support  ---- 
IB ESPs === 
USB support  ---- 
MMC/SD/SDIO card support  ---- 
< > Sony MemoryStick card support [EXPERIMENTAL] ---> 
—*— LED Support  ---- 
<*> Switch class support  ---- 
[*] &àccessibility support  ---- 
xw» шшш Cuna шиш к === 
ГІ ОМА Engine support  ---- 
[ 1 Auxiliary Display support  ---- 
< > Userspace I/O drivers 一 一 一 > 
[*] Staging drivers  ---- 


图 4-18 设备 驱动 配置 


对 内 核 驱 动 菜单 内 的 配置 项 可 以 用 一 个 表格 加 以 说 明 ， 便 于 更 好 地 了 解 内 核 驱 动 配置 以 及 各 个 驱动 模块 的 功能 ， 如 下 表 4-3 所 示 。 


表 4-3 ”驱动 模块 


驱动 子 菜单 功能 描述 
Generic Driver Options 对 应 driver/base 目录 ， 是 内 核 设备 驱动 中 一 些 基 本 和 通用 的 配置 选项 


Connector - unified userspace 
<-> kernelspace linker 


对 应 driver/connector 目录 ， 一 般 使 用 默认 配置 或 不 使 用 配置 


Memory Technology Device 对 应 /driver/mtd 目录 ， 主 要 是 支持 各 种 新 型 的 存放 装置 ， 如 NAND FALSH, 
(MTD) support NOR FIASH 等 ， 同 时 还 涉及 ECC 校 验 
对 应 /driver/parport 目录 ， 用 于 支持 各 种 并 行 端 口 设备 ， 但 在 一 般 的 府 入 式 教学 
Parallel port support oN аара 
3 台 上 用 不 到 
Block devices 对 应 /driver/block Н 3, 40236 loopback device, RAMDISK 等 设备 驱动 


对 应 /driver/misc 目录 ， 根 据 Android 系统 增加 的 驱动 设备 ， 包 括 内 存 控制 、 启 
动 停止 控制 、IPC 系统 等 驱动 

对 应 /driver/ide 目录 ， 用 来 支持 ATA/ATAPIMFMVRLL 接口 的 硬盘 、 光 盘 以 及 
软盘 等 设备 
SCSI device support 对 应 /driver/scsi H, SHEA SCSI 接口 的 设备 


Serial ATA (prod) and Parallel 
ATA (experimental) drivers 


Misc devices 


ATA/ATAPI/MFM/RLL support 


对 应 /driver/ata 目录 ， 支 持 SATA 和 PATA 设备 ， 一 般 不 用 理会 


驱动 子 菜单 


Multiple devices driver Support 


(RAID and LVM) 
Network device support 


ISDN support 

Input device support 
Character devices 

I2C support 

SPI support 

GPIO Support 

Dallas's 1-wire support 
Power supply class support 
Hardware Monitoring support 
Watchdog Timer Support 
Multifunction device drivers 
Multimedia devices 


Graphics support 


Sound card support 


HID Devices 


USB support 
MMC/SD/SDIO card support 
LED Support 

Switch class support 

Real Time Clock 


Staging drivers 


( 2 ) 
功能 描述 
对 应 /driver/md 目录 ， 表 示 多 设备 支持 RAID Al LVM, 一 般 不 用 理会 


对 应 /driver/net 目录 ， 用 来 支持 各 种 网 络 设 备 ， 如 CS8900、DM9000 以 及 无 线 


网 络 设备 等 


对 应 /driver/isdn 目录 ， 用 来 提供 实验 式 服务 数字 网 络 的 驱动 设备 
对 应 /driver/input 目录 ， 支 持 各 种 输入 装置 ， 如 鼠标 、 键 盘 和 触 控 式 屏幕 等 
对 应 /driver/char 目录 ， 它 包含 各 种 字符 设备 的 驱动 ， 如 ADC 驱动 等 
对 应 /driver/i2c 目录 ， 支 持 各 种 I2C 设备 
对 应 /driver/spi 目录 ， 支 持 各 种 SPI 设备 
对 应 /driver/gpio 目录 ， 主 要 涉及 一 些 IO 端口 的 配置 ， 如 DC 等 
对 应 /driver/wl 目录 ， 支 持 一 线 总 线 
对 应 /driver/power 目录 ， 给 不 同 设备 提供 电源 支持 ， 如 PDA/phone 
对 应 /driver/hwmon 目录 ， 主 要 用 来 监控 硬件 ， 在 一 般 般 入 式 教学 平台 上 用 不 到 
对 应 /driver/watchdog 目录 ,顾名思义 ， 所 指 的 是 看 门 狗 设备 
对 应 /driver/mfd 目录 ， 用 来 支持 多 功能 的 设备 
对 应 /driver/media 目录 ， 包 含 多 媒体 驱动 ， 如 V4L2、ov3640he 和 HDMI 等 设备 
对 应 /driver/video 目录 ， 提 供 图 形 设备 、 显 卡 驱动 的 支持 
对 应 sound Н ж (在 内 核 顶层 目录 下 )， 用 来 支持 各 种 声卡 设备 ， 如 AC97、 


wm8580 等 


对 应 /driver/hid 目录 ， 用 来 支持 各 种 USB-HID 设备 ， 如 USB 接口 的 鼠标 、 键 盘 等 


设备 


对 应 /driver/usb 目录 ， 支 持 各 种 USB HOST 和 USB Device 设备 
对 应 /driver/mme 目录 ， 用 来 支持 各 种 MMC/SD 设备 ， 如 高 速 SD + 
对 应 /driver/leds 目录 ， 支 持 教学 平台 配置 的 LED 设备 

对 应 /driverswitch 目录 ， 针 对 Android 系统 增加 的 switch 处 理 功 能 
对 应 /driverrtc 目录 ， 支 持 各 种 实时 时 钟 设备 

Android 系统 本 地 驱动 


注意 : 在 Linux 内 核 arch/arm/config 目 录 下 保存 有 多 种 平台 的 配置 文件 ， 所 以 习惯 性 地 把 要 保存 的 配置 文件 也 放置 到 arch/arm/config 目 录 下 。 如 针对 DMA-210XP 实 验 平 台 配 置 的 内 核 文件 


dma210xp_android_defconfig 也 保存 在 arch/arm/config 目 录 下 。 


44 ” Android 内核 编译 


了 解 Android 内 核 架 构 及 其 基本 配置 情况 之 后 ， 接 下 来 简单 介绍 如 何 编译 Android 内 核 源 代 码 。 


444 Android 内核 中 的 Makefile 文 件 


和 标准 的 Linux 内 核 一 样 ， 在 Android 内 核 中 ， 将 编译 哪些 文件 ”是 如 何 编译 ”编译 文件 在 连接 时 的 顺序 是 什么 ”哪个 文件 在 前 ”哪个 文件 在 后 ”哪些 文件 或 函数 将 先 被 执行 等 ”这 都 是 通过 Makefile 文 
件 来 管理 的 ， 现 在 从 最 基本 的 用 途 来 归纳 Makefile 的 作用 。 


在 内 核 程序 代码 中 ， 每 个 目录 文件 下 都 有 相关 的 Makefile 文 件 ， 这 些 文件 又 连接 了 其 他 一 些 文件 ， 例 如 连接 信息 、 配 置信 息 、 通 用 规则 等 。 在 整个 内 核 Makefile 文 件 中 可 以 分 为 以 下 几 类 ， 如 表 4-4 所 


示 。 


表 4-4 Linux 内 核 Makefile 文 件 分 类 


名 称 作用 描述 


顶层 Makefile 所 有 Makefile 文件 的 内 核 ， 从 整体 上 控制 内 核 的 编译 和 连接 
ë 设 定 文件 ， 在 配置 内 核 后 生成 。 内 核 中 所 有 的 Makefile 文件 都 是 根据 .config 来 
.confi 
决定 编译 哪些 文件 
Agel/S(ARCED/Maketile 对 应 体系 结构 中 的 Makefile， 用 来 决定 参与 内 核 编译 的 文件 ， 并 根据 相关 的 规则 
I 1 
生成 内 核 映 像 文 件 
Scripts/Makefile.* Makefile 共享 的 通用 规则 、 指 令 文件 等 
| : 各 级 子 目 录 下 的 Makefile， 是 被 上 层 中 的 Makefile 文件 调用 来 编译 目前 的 目录 
Kbuild Makefile 下 的 文件 


内 核 文 件 “Documentation/kbuild/makefile.txt” 对 内 核 中 Makefile 的 作用 和 用 法 解释 得 非常 清楚 ， 希 望 读 者 认真 地 去 读 一 下 这 个 文件 ， 这 对 了 解 内 核 编 译 有 非常 重要 的 作用 ， 下 面 简单 地 分 析 一 下 
Makefile 文 件 。 


首先 分 析 一 下 顶层 Makefile 文 件 。 内 核 的 编译 都 是 从 顶层 Makefile 文 件 开始 ， 在 编译 过 程 中 递归 地 进入 各 级 子 目录 中 并 调用 其 Makefile 文 件 。 如 在 顶层 目录 下 的 Makefile 文 件 中 可 以 看 到 如 下 内 容 : 


init-y := init/ 


drivers-y := drivers/ sound/ firmware/ 
net-y s= net 
libs-y := lib/ 
core-y := usr/ 


在 上 述 代码 中 ， 如 drivers-y， 就 是 要 执行 编译 drivers、sound 和 firmware 这 三 个 目录 下 的 文件 。 具 体 编译 哪些 文件 ， 那 就 由 drivers、sound 和 firmware 目 录 下 的 Makefile 文 件 决定 。 


在 各 级 子 目录 下 都 有 Makefile 文 件 ， 而 具体 要 执行 编译 哪些 文件 ， 这 就 得 看 .config 文 件 中 的 配置 情况 ， 读 者 应 该 清楚 ， 在 编译 内 核 前 需要 对 内 核 进行 配置 ， 配 置 后 的 文件 储存 在 .config 中 。 


除 此 之 外 ， 在 顶层 的 Makefile 和 arch/$(ARCH)/Makefile 中 设置 了 映像 文件 的 编译 、 连 接 选 项 : CFLAGS、AFLAGS、LDFLAGS、ARFLAGS， 它 们 将 决定 怎样 编译 目标 文件 。 


44. 解压 Android 内 核 源 代码 


解压 Android 内 核 源 代码 的 步骤 如 下 : 


Т) 把 Linux 内 核 压缩 文件 android_kernel_2.6.35 dma210xp.tar.bz2 复 制 到 工作 目录 下 ， 如 图 4-19 所 示 。 


2) 在 Ubuntu Linux 终 端 命令 行 执行 “tarjxvf android kernel 2.6.35 dma210xp.tar.bz2” 这 条 命令 ， 将 Linux 内 核 解压 缩 ， 解 压 完成 后 将 得 到 一 个 名 为 android_kernel_ 2.6.35 dma210xp 的 目录 ， 
图 4-20 所 示 。 


x 


o 


ach@ubuntu:~/dma210xp book/ch4$ ls 
android kernel 2.6.35 dma210xp.tar.bz2 


ach@ubuntu:~/dma210xp book/ch4$ 8 


图 4-19 复制 内 核 压 缩 文 件 到 工作 目录 下 


ach@ubuntu:~/dma216xp book/ch4$ ls 
android kernel 2.6.35 dma210xp 

android kernel 2.6.35 dma2180xp.tar.bz2 
ach@ubuntu:~/dma216xp book/ch4$ 


图 4-20 ”解压 Linux 内 核 包 


44.3 编译 Android 内 核 


编译 Android 内 核 的 步骤 如 下 : 


1) 进入 android kernel 2.6.35 dma210xp 内 核 目 录 ， 执 行 “make clean” 这 条 命令 ， 清 除 先前 编译 生成 的 文件 ， 如 图 4-21 所 示 。 


ach@ubuntu:~/dma210xp book/ch4$ cd android kernel 2.6.35 dma210xp/ 
ach@ubuntu:~/dma210xp book/ch4/android kernel 2.6.35 dma210xpS$ make clean 


ach@ubuntu:~/dma210xp book/ch4/android kernel 2.6.35 dma210xp$ 


图 4-21 执行 “make clean" #4 


2) 修改 内 核 目录 下 的 Makefile 文 件 中 交叉 编译 程序 的 路 径 ， 执 行 “vi Makefile” 这 条 命令 ， 使 用 VI 编 辑 器 打开 Makefile， 找 到 “CROSS COMPILE=” 这 一 行 ， 如 图 4-22 所 示 。 


图 4-22 ”查看 Makefile 文 件 


通过 图 4-22 可 以 知道 ， 交 叉 编译 程序 的 内 容 是 在 内 核 根 目录 下 的 .cross_compile 文 件 内 。 退 出 Makefile 文 件 ， 在 当前 目录 下 执行 “cat.cross_compile” 这 条 命令 来 查看 .cross_compile 中 的 内 容 ， 如 图 


ach@ubuntu:~/dmé210xp book/ch4/android kernel 2.6.35 dma210xp$ 
cat .cross compile 
/usr/local/arm/erm-2009q03/bin/arm-none-linux-gnueabi - 
ach@ubuntu:~/dmée210xp book/ch4/android kernel 2.6.35 dma210xp$ 


4-23 ”查看 .cross_compile 文 件 


若 .cross_compile 文 件 中 的 内 容 不 是 “/usr/local/arm/arm-2009q3/bin/arm-none-linux-gnueabi-”， 则 需要 修改 成 上 面 的 交叉 编译 程序 及 其 路 径 ， 修 改 完成 后 储存 并 退出 。 


3) 配置 内 核 。 输 入 命令 “make dma210xp_android_defconfig”， 读 取 针 对 DMA-210XP 的 Android 内 核 配置 ， 然 后 执行 “make zlmage” 这 条 命令 编译 内 核 ， 如 图 4-24 所 示 。 


注意 : dma210xp_android_defconfig 是 针对 DMA-210XP 实 验 平台 的 Android 内 核 配 置 文 件 ， 它 保存 在 内 核 arch/arm/configs/ 目 录 内 ， 在 配置 内 核 出 错 的 情况 下 读者 可 以 读 取 它 来 还 原初 始 化 配置 。 
另外 在 内 核 目录 下 保存 了 一 个 config_dma210xp 文 件 ， 即 内 核 配 置 选项 。 可 以 执行 命令 “cp-rf config_dma210xp.config” 来 代替 “make menuconfig” 命 令 ， 从 而 配置 内 核 。 然 后 执行 “make 
zlmage” 命 令 即 可 编译 内 核 。 


4) 编译 成 功 后 将 会 在 arch/arm/boot/ 目 录 下 生成 内 核 映像 文件 zlmage， 如 图 4-25 所 示 。 


ach@ubuntu:~/dma2léxp book/ch4/android kernel 2.6.35 dmazl18xp$ make zImage 
scripts/kconfig/canf -s arch/arm/Kconfig 
CHK inc Lude/ Linux/version.h 
UPO include; Linux, version. h 
СНК include/generated/utsreleass.h 
UPO ine lude/ygenmeraled/ulsrelease. і 
Generating include/generated/mach-types.h 
CC kernel/bounds. s 
GEN inc Lude/generated/bounds.h 
CC arch/arm/kernel/asm-offsets.s 
GEM include/generated/asm-offsets.h 
CALL scripts/checksyscalls.sh 
CC scripts/mod/empty.o 
HOSTCC scripts/mad/mk elfcanfig 
MKELF — scripts/mad/elfconfig.h 
HOSTCC  scripts/mnd/filezalias.o 
HOSTCC  seripts/mad/madpast.n 
HOSTCC X scripts/mod/sumversion.o 
HOSTLD scripts/mod/modpost 
HOSTCC  scripts/kallsyms 


图 4-24 ”编译 内 核 


System .map 
.tmp System.map 
arch/arm/boot / Image 
arch/arm/boot/Image is ready 
arch/arm/boot / compressed/head.o 
arch/arn/boot/compressed/piggy.gzip 
arch/arm/boot /Compressed/piggy.gzip.o 
arch/arm/boot/compressed/misc.o 
arch/arm/boot/compressed/decompress.o 
SHIPPED arch/arm/boot/compressed/liblfuncs.S 
AS arch/arm/boot/compressed/1iblfuncs.o 
LD arch/arm/boot/compressed/ vmlinux 
OBJCOPY arch/arm/boot/zImage 
Kernel: arch/arm/boot/zImage is ready 
cp -f arch/arm/boot/zImage ./zImage 
ach@ubuntu:~/dma210xp book/ch4/android kernel 2.6.35 dma216xpS ls arch/arm/boot/ 
compressed Image install.sh Makefile  zImage 
book/ch4/android kernel 2.6.35 dma216xps 


94-25 “生成 内 核 映像 文件 zImagk 


在 编译 之 后 读者 会 发 现在 内 核 目 录 下 也 存在 一 个 zlmage 文 件 ， 这 是 特别 制作 的 zlmage 备 份 文件 。 与 arch/arm/boot 目 录 下 的 zlmage 是 同一 个 文件 。 


在 读者 执行 “make clean” 命 令 的 情况 下 ， 不 用 再 去 重新 编译 内 核 ， 可 以 直接 使 用 该 zlmage 文 件 。 编 译 Android 内 核 的 最 终 目的 就 是 得 到 zlmage 文 件 ， 并 把 zlmage 烧 写 到 Nand Flash 中 。 


45 DMA-210XP 平 台 Android 文 件 系 统 烧 写 


4.5.1 ” 烧 写 u-boot 到 Nand Flash 


在 通过 USB 下 载 前 ， 先 要 完成 硬件 上 的 连接 ， 如 POWER_5V 端 连接 5V 电 源 ， 使 用 Mini USB 线 连接 PC 主机 和 DMA-210XP 实 验 平台 的 USB_OTG 端 ，UART0 端 连接 串 行 线 ，CON1 端 连接 LCD 屏 幕 。 确 定 
硬件 连接 没有 问题 之 后 就 可 以 开始 下 载 、 烧 写 了 ， 操 作 步 骤 如 下 。 


Т) 先 对 DMA-210XP 实 验 平台 的 SW8 跳 线 开关 进行 设置 ,将 SW8 (OM5~OM0) 置 为 100011， 跳 线 方法 如 图 4-26 所 示 。 


图 4-26 ”SW8 跳 线 开关 设置 


2) 打开 DNW 软 件 ， 然 后 给 DMA-210XP 实 验 平台 上 电 。DNW 终 端 软件 显示 如 图 4-27 所 示 “USB: OK” 就 表示 USB 与 PC 连接 成 功 ， 否 则 需要 安装 USB 驱 动 。 


3) 点 击 “Configuration” 一 “Options”， 设置 USB 参 数 ， 如 图 4-28 所 示 。 


DEF 51.01 USE 2.0 compatible — [CON:x][USB:OK] |. | ` |> 
Serial Port USB Tert Configuration Help 


4-27 USB 与 PC 连接 成 功 


UAET/USB Options 


- Serial Рогі 
Haud Hate COM Port / | 


\ | 


= 116200 ][* COM 1 | ^ Cancel | 


^ 57600 С COM? | 
^ 38400 COM 3 
^ 19200 C COM 4 


C 14400 
1 9600 


-USE Port 
Download Address 


4) Ah "Serial Port” 一 “Connect” 连 接 串 行 口 ， 连 接 成 功 之 后 如 图 4-29 所 示 。 


OM1，115200bps” 分 别 表示 串 行 口 和 使 用 的 波 特 率 。 


5) 点 击 “USB Port” 一 “DownLoad” 下 载 USB 引 导 文 件 V210_USB.BL2.bin 到 内 存 中 ， 如 图 4-30 所 示 。 


DAW vi 0! TS 2.0 compatible [COWi, ri5200bpsl[Wsñ8-nrz1[ | | x | 


Serial Port UGG Port Configuration Help 


图 4-29 ”连接 成 功 


mies: | £3 заре inaze -| P [£j ci H- 


АН WZH 


рало w3. ELZ. bir. -| 
[ати File: (к. bjc :让 . ПАП] т j 


4-30 下载 USB 引 导 文件 


点 击 “ 打 开 ” 按 钮 完成 下 载 。 


6) 下 载 V210_USB.BL2.bin 之 后 ，DNW 软 件 会 显示 USB 联 机 短暂 呈现 断 开 状态 ， 之 后 又 马上 连接 上 。DNW 软 件 界面 如 图 4-31 所 示 。 


7) 点 击 “Configuration ”一 “Options”， 修 改 下 载 u-boot.bin 文 件 的 内 存 地 址 。 修 改 为 0x23e00000， 设 置 如 图 4-32 所 示 。 


DNE у1.01 USB 2.0 compatible [CON], 115200bp=] [USBzOET [L Af] 


4-31 DNW 软 件 界 面 


UARI/USB Options 


Serial Port 
— Baud Rate 


+ 115200 
S700 
48400 


13200 
14400 


4600 


Cancel 


^ 


k NE NE | 


USB Port 


Download Address |Ux23e00040/ 


图 4-32 ”设置 u-boot 下 载 地 址 


8) mh "USB Port" > "DownLoad" , 下 载 u-boot.bin 文 件 ， 如 图 4-33 所 示 。 


9) 点 击 “ 打 开 ” 按 钮 之 后 ，DNW 软 件 会 显示 u-boot 的 启动 界面 ， 如 图 4-34 所 示 。 


此 时 ，u-boot 了 映像 文件 成 功 在 内 存 中 执行 。 接 着 需要 做 的 就 是 把 u-boot 映 像 文 件 烧 写 到 Nand Flash。 让 u-boot 从 Nand Flash 启 动 起 来 。 


10) 在 DNW 终 端 软件 输入 “dnw 0xc0008000” 命 令 ， 把 u-boot 映 像 文 件 下 载 到 记忆 体 地 址 为 0xc0008000 (虚拟 地 址 ) 的 地 方 ， 这 与 之 前 的 0x23e00000 地 址 是 不 同 的 。 读 者 要 注意 区 别 ， 如 


所 示 。 


11) 然后 点 击 “USB Port” 一 “DownLoad”， 下 载 u-boot.bin 文 件 到 内 存 中 ， 如 图 4-36 所 示 。 


E Sanple image 


ya-boot, bin 


BIH Files [k,.birn;*.mnbU] 


图 4-33 T #u-boot Xx fF 


DAY 71.01 USE 2.0 compatible  [CON1, I15200bns] [TSB:z] ВЫЕ 
Serial Fori TEB Port Contigoretion Help 


CPU: БРИТ BOOMHZ (UI) 
APLL = iBüBHHz, HclkhMsgs - 28BHHHz, PclkMsgs = 1BüHHz 
MPLL = 567MHz, EPLL = BØMHZ 
HE 1к0505 = T6ó6HMHz, PCe1RDSügS = B3MHz 
HCIKPsys = 133MHz, PClkPsys = 65MHz 
БСІКА2М = 2B8B8kHHz 
serial = CLAUART 
D Hñ -2183P 
1 EB 
ar a 1MB 
512 MB 


eee Warning - using default environment === 


Serial 


SPF ial 


checking Mode for Fastboot ... 


Hit any key to stop autohoot: B 


DMAZIOAP d 


4-34 u-boot 在 内 存 中 的 执行 


DEW v1.01 USB 2.0 compatible [COM], 11 52DDbps1L. .. [` |) > 


Serial Fort USE Tort Configuration Help 


Іп: serial 

Out: serial 

Err: serial 

1876HBH 

checking mode for Fastboot ... 
Hit any key to stop autoboot: W 
DHA21GXP H dnu üxcag8Bsad8 

OTG cable Connected! 


Hou, Waiting for DHU to transmit data 


图 4-35 设置 下 载 命令 


E) Sanple image 


BIN Files fk. Біг; ж. nb] 


84-36 “下载 u-boot 映 像 文件 


12) 点 击 “ 打 开 ” 按 钮 之 后 ，DNW 软 件 会 显示 u-boot 的 下 载 信息 ， 如 图 4-37 所 示 。 


13) 使 用 扩充 命令 烧 写 u-boot 到 Nand Flash 中 ， 输 入 命令 “run uu” 即 可 ， 如 图 4-38 所 示 。 


DHF 1.01 USB 2.0 compatible [CON], 115200bps] 10... fa EX] 
Sarial Fort VER Fort Configoration  Halp 


checking mode For Fastboot ... 


Hit any key to stop autoboot: 0 


DHdh218x5P H dnu бъгав аде 
UTE cable Connected! 
How, Waiting for DHW to transmit data 


Download Donet? Download Address: BxrBBB8888., Download 
Filesize : @x4c BBB 


Checksum is being calculated. 
Checksum ОК. 


UPHZTBAF H 


84-37 下载 完成 


DHF 1.01 USB 2.0 compatible [СОШІ, 115200ър=110... (Е |/B|[X| 


Serial Port WSB Port Configuration Help 
DHA218XP H run uu 


HAHD erase: device B ofFset Ox, size ЙхНИЙИЙ 


Erasing at x — complete. 
Erasing at 0х20000 5»nmplete. 
Erasing at BxhB8BBH 7omplete. 
Erasing at Bx6BBBH 1üBromplete. 


НАНО write: device B offset 8x6, size Bx8HBHH 
Checksum 15 calculated. 
Hain area write {Н blocks): 


L25288 bytes written: OK 


DHRa21B8XP # | 


图 4-38” 烧 写 u-boot 到 Nand Flash 


14) 为 了 检验 u-boot 是 否 成 功 烧 写 到 Nand Flash 当 中 ， 首 先 把 DMA-210XP 实 验 平 台 关 掉 电源 ， 再 把 跳 线 开关 SW8 设 置 成 为 000011， 重 新 对 平台 开启 电源 ， 让 u-boot 从 Nand Flash 启 动 ，SW8 的 设 


如 图 4-39 所 示 。 


54-39 ”SW8 开 关 设 置 


15) u-boot 从 Nand Flash 成 功 启动 的 界面 如 图 4-40 所 示 。 


DNE vl. 01 USB 2.0 compatible [COM], 115 2ü0Dbps=][USH:z] 
Serial Fort USE Fori Cantigoration Help 


СРИ: SS5PU21 0A BOBEOPH: СОК } 

APLL = 188HHz, HclkHMsys = 208HHz, PclkHMsus = TüBHHz 

HPLL = 6657MHz, EPLL = RüMHz 
HclEDzys Te66nmHz, PclEDsys = BJHHz 
HclkPsys = 133HHz, PelkPsys = НН 
SCLRASH 2 DAM? 

CLHURRT 

DHà-2468xP 

GB 
3T7B1HhEB 
51? HB 


жак Warning - using default environment sx 


serial 
serial 


serial 


checking mode for Fasthookt ... 


Hit any key to stop autoboot: 4 


ОНА21 ВКР H 


4-40 u-boot# Nand Flash 中 启动 


到 此 ，u-boot 就 成 功 地 烧 写 到 Nand Flash 中 了 。 下 面 需要 做 的 就 是 通过 Nand Flash 中 的 u-boot 烧 写 内 核 和 Android 文 件 系统 到 Nand Flash 中 。 


4.5.2” 烧 写 zlmage 内 核 映像 文件 


烧 写 zlmage 内 核 映 像 文 件 的 步骤 如 下 : 


Т) 在 DNW 终 端 软件 输入 命令 “dnw” 下 载 内 核 (注意 : 在 窗口 列 显示 “USB:OK” 之 后 ， 才 可 以 下 载 ) ， 如 图 4-41 所 示 。 


2) 点 击 “USB Port” > "DownLoad" ,下 载 内 核 映像 文件 zlmage， 如 图 4-42 所 示 。 


3) 在 DNW 终 端 软件 输入 烧 写 命令 “run uk” 后 按 “Enter” 键 ， 如 图 4-43 所 示 。 


4) 烧 写 完成 ， 如 图 4-44 所 示 。 


[CON1, 115200bps] [TsB=og] [- [| x) 


DHW v1.01 USH 2.0 compatible 
Serial Fort USB Fort Configuration Help 
DHAZ1 BRP H dnw 


OTG cable Connected? 


Hov, Waiting for DHW to transmit data 


图 4-41 下 载 内 核 


SEND. [E Sanple_tmage -| © © еў Е: 


uzerdsta ing 


= AES 8): [zTnage -| 
THM Т): n Files (*.*] =| 


4-42 ”打开 内 核 映像 文件 zImagk 


DAW v1.01 USB 2.0 compatible [CON], 115200Ьр=1105В:х1 [_ [|x] 


Serial Fort USE Port Configuration Help 


Checksum is being calculated.... 


Checksum ü.K. 


DHAZIAAP H run uk 


图 4-43 在 DNW 终 端 软件 输入 烧 写 命令 “run uk” 


DAF =1.01 USB 2.U compatible [COML, 115200ър=] [USH: z] 


Serial Fort IEE Fort Configuration Help 
HAHD write: device B offset BzñBDBBBD, size Mrs 


Hain area write (58 blocks}: 


52428898 bytes written: UK 


ОМА? ОХР # | 


84-44 3⁄5 ZR 
4.5.3 #5ramdisk-uboot.img ARSC 


烧 写 ramdisk-uboot.img 映 像 文件 的 步骤 如 下 : 


1) 在 DNW 终 端 软件 输入 命令 “dnw”,， 下 载 [amdisk_uboot.img 文 件 ， 如 图 4-45 所 示 。 


2) 点 击 “USB Port” > "DownLoad" , 下 载 文件 ramdisk_uboot.img， 如 图 4-46 所 示 。 


DEW vi.01 USB 2.0 compatible [СОШІ, 115200bpz] [USB:OE] (Е [|x] 
Serial Fort USE Fort Configuration Help 
DHAZTOXP # апи 


OTG cable Connected? 


How, Waiting For DHW to transmit data 


94-45 F 3Xramdisk uboot.img X F 


Sia Е: [E Sanple_Inage >| 


六 sdfore 


EL ing 
SERINW ПЕШ Driver. car 


" - 
"misi xl 


Фарз. mra 


[E u-boot. bin 
E uxerdat в. imx 
[Ej 0210 MEB BLE. bin 


E Ітак 


THS (HJ: F amdixk-ubnnt.imz =| 
TORS (1): n Files [€ W) ”| Lar 


图 4-46 47 7Framdisk uboot.img x #F 


3) 在 DNW 终 端 软件 输入 烧 写 命令 “run ur”， 如 图 4-47 所 示 。 


4) 烧 写 完成 ， 如 图 4-48 所 示 。 


DEW v1.01 USB 2.0 compatible [CONI.115200bps][USB:z] [| 口 | 区 | 
Serial Part USE Fort Configuration Help 
Filesize : #х220161 


Checksum is being calculated. 


Checksum П.К. 


ОНА21 ХР H run ur 


图 4-47 在 DNW 终 端 软件 输入 烧 写 命令 “run ur” 


DEF v1.01 USB 2.0 compatible [C0ONI.115200bps][USB:z] (2 1] 
Serial Port USB Port Configuration Help 
НАНО write: device ü offset BüxbBHBHBHBHB, size Hx3BHBBBH 


Hain area write (24 blocks): 


3145728 bytes written: OK 


рМа21 ВХР # | 


图 4-48” 烧 写 完成 
454 烧 写 Android System.img 文 件 


烧 写 Android System.img 文 件 的 步骤 如 下 : 


1) 在 DNW 终 端 软件 输入 命令 “dnw”， 下 载 system.img 文 件 ， 如 图 4-49 所 示 。 


2) 点 击 “USB Port” — "Download" , 下载 system.img 文 件 ， 如 图 4-50 所 示 。 


DAW vi.01 USB 2.0 compatible [CON1,115200bpz] [UsB:0K] |. [C || 
Serial Port USE Port Configuration Help 
ЮМА210ХР # anw 


OTG cable Connectedt 


Now, Waiting for DHU to transmit data 


4-49 ”下载 system.img 文 件 


El u-beot. bin 
El uasrdatsa. 3 LII 
(Ej 210 USE BLE. bin 


国 zImaze 


пива: [шетш 可 
TH IL): [11 Piles (+. #1 -| Wn 


4-50 ”打开 system.img 文 件 


system.img 文 件 比 较 大 ， 会 出 现 如 图 4-51 所 示 界 面 。 


3) 在 DNW 终 端 软件 输入 烧 写 命令 “run us”， 如 图 4-52 所 示 。 


4) 烧 写 完成 ， 如 图 4-53 所 示 。 


Downloading C:\Documents and Settings Admin... | > | 


4-51 ”加 载 进程 


BN ll USH 


14-52 ”在 DNW 终 端 软件 输入 烧 写 命令 “run us” 


DEF vidi DSE 2 compatible — [CóNi, i16200hps 103622) [LR 


Serial Fari VER Fort Configoratian Halp 


Writing data at BxTeeaBHBB -- Jomplete. 
uriting data at BxgB1100m -- Fomplete. 
Writing data at üx£i127H8ÀB 一 一 dünmnplete. 


125555936 bytes written: UK 


HAZI 05Р H 


图 4-53” 烧 写 完成 


4.5.5 ” 烧 写 Android userdata.img 文 件 


烧 写 Android userdata.img 文 件 的 步骤 如 下 : 


Т) 在 DNW 终 端 软件 输入 命令 “dnw”， 下 载 userdata.img 文 件 ， 如 图 4-54 所 示 。 


2) 点 击 “USB Port” 一 “DownLoad”， 下 载 文件 userdata.img 文 件 ， 如 图 4-55 所 示 。 


DAW v1.01 USB 2.0 compatible — [CONI, 116200bps] [VSB:0OE] [- [P|] 
Serial Part SB Port Configuration Help 
ГМА21 EXP # dnw 


OTG cable Connected! 


Hou, Waiting For DHW to transmit data 


图 4-54 在 DNW 终 端 软 件 输入 命令 “dnw” 


= randı sk—aback. img 
图 xw-=k =. ing 


B uxerdaimx. ama 


(Ej 0210 ШЕВ BLE. bin 


图 rlmsz= 


THS OW: [user daia ing - 
THS ITO: n Files bx Ф) “| EH 


4-55 ”打开 userdataimg 文 件 


3) 在 DNW 终 端 软件 输入 烧 写 命令 “run ud”， 如 图 4-56 所 示 。 


4) 烧 写 完成 ， 如 图 4-57 所 示 。 


DA v1.Ul USE 2.0 compatible [COMI, 11520Ubpe] [USB:z] [a ||E x| 


Бакта] Port UGE Port Configuration Help 
Filesize -@<44acc й 


Checksun is being calculated 


Checksun U.K. 


ОМА21 ХР # run ud 


图 4-56 在 DNW 终 端 软件 输入 烧 写 命令 “run ud" 


DNW v1.Ul USE 2.0 compatible [COMI,115z0Ubpz] [USB:z] [a |O] 


Бакта] Pert UGE Port Configuration 
Uriting data at йхйа1Нййй --  Joumplete. 


Writing data at HxdaileBHB -- Jomplete. 
Uriting data at Bada298ñü -- 1Bomplete. 
45BB672 bytes written: UK 


DHA6248NP # | 


4-57 YES SL, 


45.6 启动 Android 系 统 


完成 以 上 4.5.2 节 ~4.5.5 节 介绍 的 操作 之 后 ， 就 可 以 启动 Android 系 统 了 。 将 DMA-210XP 实 验 平 台 的 电源 关闭 ， 再 重新 启动 。 数 分 钟 之 后 可 以 在 LCD 屏 幕 上 看 到 Android 系 统 画面 ， 如 图 4-58 所 示 。 


Q fl €3 3:57 AM 


Phone Contacts Browser | 


图 4-58 Android & ARM 


4.5.7 TF 卡 自动 更 新 kernel 和 Android 系 统 文件 


使 用 TF 卡 自动 更 新 的 前 提 是 Nand Flash 中 已 经 存在 u-boot 引 导 程序 ， 否 则 就 需要 把 u-boot.bin 程 序 烧 写 到 Nand Flash 中 。 下 面 介 绍 一 下 TF 自动 更 新 kernel 和 Android 系 统 文件 的 过 程 。 


1) DMA-210XP 实 验 平台 的 POWER_5V 连 接 5V 电 源 ，UART0 以 串口 串 行 线 连接 PC 串 行 口 。 在 J20 卡 座 上 插 上 TF 卡 。 


注意 : 更 新 系统 之 前 需要 把 更 新 的 zlImage、ramdisk-uboot.img、syste.img 和 userdata.img 文 件 复 制 到 TF 卡 的 根 目录 下 。 否 则 系统 会 找 不 到 对 应 的 文件 。 


2) 按 住 MENU 键 ， 然 后 开启 DMA-210XP 实 验 平 台 的 电源 。 从 串 行 口 的 输出 信息 可 以 看 出 ，u-boot 正 在 进行 自动 更 新 kernel 和 Android 系 统 文件 ， 在 更 新 的 过 程 中 ，LED D2 和 LED D5 会 先 熄灭 。 等 到 
更 新 完 之 后 ， 又 会 自动 亮 起 ， 并 且 会 关闭 LCD 背 光 ， 提 示 更 新 完成 。 这 样 在 没有 debug 串 行 口 的 情况 下 ， 也 可 以 知道 系统 是 否 已 经 完成 了 自动 更 新 ，Debug 信 息 如 图 4-59 所 示 。 


3) 更 新 完成 之 后 ， 系 统 会 自动 重新 启动 ， 并 进入 Android 系 统 ， 如 图 4-60 所 示 。 


Partitiani: Start Addressl(m@n0), Size (tm Tazo) 
reading v bog t: bin 


E [hable tà read tron nell) Wil РЕ 
Tha fila u-bapt, bin is not exsit in ED/HNC card 
Par Liliun: "Lan L ÉdliceailDaDÓü, 
кашыр sImage 


0 I! eo d. r." 
Fare d Foe ] 


i 
ü"hbant,hain 


HAND erase: devica Q offzat окб) 
at бу ае - 


J, aize Üxhbüo 
100% complete. 


MAND write: 
Wain 


device t 


атаа write (do 


L 
Dai 


offset ú size Ux OOOO 
hlorka): 
42880 bytes written: OF 
Partitianl: Start 


=] = "milli 


Address loeo)! 


EE а Wi T u 
reading ramdish-uboot. ing 


e [Qha Ti 2 do) 
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4-60 重新 启动 后 进入 Android 系 统 


Жон ”系统 硬件 与 驱动 程序 


5.1 Android 硬件 抽象 层 (HAL) 


Android 的 硬件 抽象 层 是 对 Linux 内 核 驱动 程序 的 封装 ， 向 上 提供 接口 ， 屏 蔽 低层 的 硬件 。 把 对 硬件 的 支持 分 成 了 两 层 ， 一 层 放 在 用 户 空间 ， 另 一 层 放 在 内 核 空间 。 硬 件 抽象 层 运行 在 用 户 空间 ， 而 
Linux 内 核 驱动 程序 运行 在 内 核 空间 。Android 硬 件 抽象 层 如 图 5-1 所 示 。 


Android 硬 件 抽象 层 由 Android 系 统 的 硬件 驱动 层 、 硬 件 抽象 层 、 运 行 时 库 和 应 用 程序 框架 层 等 组 成 。 通 过 学 习 Android 硬 件 抽象 层 ， 了 解 在 内 核 空间 编写 硬件 驱动 程序 ， 在 硬件 抽象 层 中 添加 接口 支持 
访问 硬件 ， 在 系统 启动 时 提供 硬件 访问 服务 ， 以 及 编写 JNI 通 过 Java 接 口 来 访问 硬件 。 


NER w Ee FP 


[Мат 


存根 类 


Linuxiz 7 JK 5) 


图 5-1 ”Android 硬件 抽象 层 


5.1.1 内核 硬件 驱动 程序 


Android 系 统 编写 内 核 驱动 程序 使 用 一 个 虚拟 的 硬件 设备 ， 这 个 设备 只 有 一 个 4 字 节 的 寄存 器 ， 对 寄存 器 可 以 进行 读 写 操作 。 把 这 


序 。Android 内 核 驱动 程序 和 一 般 Linux 内 核 驱动 程序 的 编写 方法 相同 ， 这 里 从 Android 系 统 的 角度 来 描述 Android 内 核 驱动 程序 的 编写 和 编译 过 程 。 


1. 在 kernel/drivers 目 录 新 建 hello 目 录 


个 虚拟 的 设备 命名 为 “hello” 


， 而 内 核 驱 动 程序 也 命名 为 hello 驱 动 程 


zyhu@ubuntu-50:~/work/kernel$ cd drivers/ 
zyhu@ubuntu-50:~/work/kernel/drivers$ mkdir hello 


2. 在 hello 目 录 中 增加 hello.h 文 件 


hello.h 
#ifndef HELLO ANDROID H 
#define HELLO 2 ) ANDROID H` 
#include <linux/cdev.h> 
#include <linux/semaphore.h> 
#define HELLO DEVICE NODE NAME "hello" 
#define HELIO DEVICE FILE NAME "hello" 
#define HELIO DEVICE PROC NAME "hello" 
#define HELLO DEVICE CLASS NAME "hello" 
struct hello_android dev ( 

int val; 

struct semaphore sem; 

struct cdev dev; 
1; 
#епаіғ 


在 hello.h 头 文件 中 定义 了 一 些 字符 串 常量 宏 ， 并 定义 了 一 个 字符 设备 结构 体 hello_android_dev， 对 应 虚拟 的 硬件 设备 ，val 成 员 
定义 字符 设备 结构 体 的 标准 方法 。 


号 量 ， 用 同步 访问 寄存 器 val，dev 成 员 变 量 是 一 个 内 嵌 的 字符 设备 ， 这 就 是 Linux 驱 动 程序 


3. 在 hello 目 录 中 增加 hello.c 文 件 


变量 就 代表 设备 里 


H 


的 寄存 器 


， 它 的 类 型 为 int，sem 成 员 


=== 
TOSSES: 


是 一 个 信 


驱动 程序 的 功能 主要 是 向 上 层 提供 访问 设备 的 寄存 器 的 值 ， 包 括 读 和 写 操作 。 驱 动 程序 提供 了 三 种 访问 设备 寄存 器 的 方法 ， 一 是 通过 proc 文 件 系统 来 访问 ， 二 是 通过 传统 的 设备 文件 的 方法 来 访问 ， 三 


是 通过 devfs 文 件 系统 来 访问 。 下 面 是 驱动 程序 的 代码 : 


Hello.c 

/* 包 含 必要 的 头 文件 和 定义 三 种 访问 设备 的 方法 */ 

finclude <linux/init.h> 
#include <linux/module.h> 
#include <linux/types.h> 

finclude «linux/fs.h» 

#include «linux/proc fs.h» 

#include «linux/device.h» 
#include «asm/uaccess.h» 
#include "hello.h" 

/* 主 设备 和 从 设备 号 变量 */ 


static int hello major = 0; 


static int hello minor = 0; 

/* 设 备 类 别 和 设备 变量 */ 
static struct class* hello class = NULL; 
static struct hello ' android dev* hello dev = NULL; 

/* 传 统 的 设备 文件 操作 方法 */ 
static int hello open(struct inode* inode, struct file* filp); 
static int hello_release(struct inode* inode, struct file* filp); š 
static ssize_t hello_read(struct file* filp, char _user *buf, size t count, loff t* f pos); 
static ssize t hello: ) write(struct file* filp, const char _user *buf, size t count, loff t* f pos); 
/* 设 备 文件 操作 方法 表 */ 
static struct file operations hello fops = ( 

.owner = THIS MODULE, 

.open = hello open, 

.release = hello release, 
.read = hello read, 

.write = hello write, 


1; 
/* 访 问 设置 属性 方法 */ 
static ssize_t hello_val_show(struct device* dev, struct device_attribute* attr, char* buf); 
eee ssize t hello ^ val | . Store(struct device* dev, struct device | attribute* attr, const char* buf, size t count); 
定义 设备 属性 */ 
decr DEVICE ATTR(val, S IRUGO | S IWUSR, hello val show, hello val store); 
/* 定义 传统 的 设备 文件 访问 方法 ， 主 要 是 定义 hello open, hello release、hello read 和 hello_write 这 4 个 打开 、 释 放 、 读 和 写 设备 文件 的 方法 */ 
/* 打 开设 备 方法 */ 
static int hello open(struct inode* inode, struct file* filp) Í 
struct hello ао as up: dev; 
/* 将 自 定义 设备 结构 体 保存 在 文件 指针 的 私有 数据 域 中 ， 以 便 访 问 设备 时 使 用 */ 
dev = container of(inode-»i cdev, struct hello android dev, dev); 
filp-»private data - dev; 
return 0; T 
/* 设 备 文件 释放 时 调用 ， 空 实现 */ 
static int hello release(struct inode* inode, struct file* filp) { 
return 0; 


l 
/* 读 取 设 备 的 寄存 器 Val 的 值 */ 
static ssize t hello read(struct file* filp, char _ user *buf, size t count, loff_t* f pos) { 
ssize t err = 0; 
struct hello | android_dev* dev = filp->private_data; 
/* 同 步 访问 */ 
if (down_interruptible(&(dev->sem))) { 
return -ERESTARTSYS; 
} 
if(count < sizeof (dev->val)) { 


goto out; 
} 
/* 将 寄存 器 val 的 值 复制 到 用 户 提供 的 缓冲 区 */ 
if(copy to user(buf, &(dev->val), sizeof(dev-»val))) { 
err = -EFAULT; 
goto out; 


err = sizeof (dev-»val); 
out: 

up (& (dev-»sem)); 
return err; 


/* 写 设备 的 寄存 器 值 val*/ 
static ssize t hello write(struct file* filp, const char _ user *buf, size t count, loff t* f pos) { 
struct hello android dev* dev = filp-»private data; 
ssize t err = 0; 
/* 同 步 访问 */ 
if (down_interruptible(&(dev->sem))) { 
return -ERESTARTSYS; 


if(count != sizeof(dev-»val)) { 
goto out; 


š 
/* 将 用 户 提供 的 缓冲 区 的 值 写 到 设备 寄存 器 中 */ 
if(copy from user(&(dev-»val), buf, count)) { 
err = -EFAULT; 
goto out; 
] 
err = sizeof (dev-»val); 
out: 
up (& (dev->sem) ) ; return err; 


l 
/* 定义 通过 devfs 文 件 系 统 访问 方法 ， 把 设备 的 寄存 器 Val 看 成 是 设备 的 一 个 属性 ， 通 过 读 写 这 个 属性 来 对 设备 进行 访问 ,主要 是 实现 hello_val_show 和 hello_val_store 两 个 方法 ， 同 时 定义 了 两 个 内 部 使 用 的 访问 val 值 的 方 
/* 读 取 寄存 器 val 的 值 到 缓冲 区 buf 中 ， 内 部 使 用 */ 
static ssize t _ hello get val(struct hello android dev* dev, char* buf) { 

int val = 0; 

/* 同 步 访问 */ 

if (down interruptible(& (dev->sem))) { 
return -ERESTARTSYS; 


val = dev-»val; 
up (& (dev->sem) ) ; 
return snprintf (buf, PAGE SIZE, "Sd\n", val); 
} 
/* 把 缓冲 区 buf 的 值 写 到 设备 寄存 器 val 中 去 ， 内 部 使 用 */ 
static ssize t _ hello set val(struct hello android dev* dev, const char* buf, size t count) { 
int val = 0; 
/* 将 字符 串 转换 成 数字 */ 
val = simple strtol (buf, NULL, 10); 
/* 同 步 访问 */ 
if (down interruptible (&(dev-»sem))) { 
return -ERESTARTSYS; 
) 
dev-»val = val; 
up (& (dev-»sem)) ; 
return count; 


} 
/* 读 取 设 备 属性 val*/ 
static ssize t hello val show(struct device* dev, struct device attribute* attr, char* buf) { 
struct hello ; android dev* hdev = (struct hello android | dev*) dev ' get. drvdata (деу); 
return . hello | get val(hdev, buf); 


} 
/* 写 设备 属性 val*/ 
static ssize t hello val store(struct device* dev, struct device attribute* attr, const char* buf, size t count) { 
struct hello ; android « dev* hdev = (struct hello android dev*)dev ' get « drvdata (dev) ; 
return . hello | set . val (hdev, buf, count); 


定义 通过 proc 文 件 系统 访问 方法 ， 主 要 实现 了 he1L1o proc readfehello proc write 两 个 方法 ， 同 时 定义 了 在 proc 文 件 系 统 创建 和 删除 文件 的 方法 hello_create_proc 和 hello_remove proc*/ 
a 保存 在 page 缓 冲 区 中 * / 
static ssize t hello proc read(char* page, char** start, off t off, int count, int* eof, void* data) { 
if(off » 0) ( 
*eof = 1; 
return 0; 


} 
return _ hello get val(hello dev, page); 


} 
/* 把 缓冲 区 的 值 buff 保 存 到 设备 寄存 器 val 中 */ 
static ssize_t hello_proc_write(struct file* filp, const char _ user *buff, unsigned long len, void* data) { 
int err = 0; 
char* page = NULL; 
if(len > PAGE_SIZE) { 
printk (KERN ALERT"The buff is too large: %lu.\n", len); 
return -EFAULT; 
} 
page = (char*) get free page(GFP KERNEL); 
f(page) { 
printk(KERN ALERT"Failed to alloc page. Wn"); 
return -ENOMEM; 


/二 把 用 户 提供 的 组 站 区 值 复制 到 到 内 核 缓冲 区 中 */ 

if(copy from user(page, buff, len)) { 
printk(KERN ALERT"Failed to copy buff from user.\n"); 
err = -EFAULT; 
goto out; 

} 

err = hello set val(hello dev, page, len); 


out: 
free page ( (unsigned long) page) ; 
return err; 


l 
/* 创 建 /proc/hello 文 件 */ 
static void hello create proc(void) { 
struct proc dir entry* entry; 
entry = create proc entry (HELLO DEVICE PROC NAME, 0, NULL); 
if(entry) { 
entry->read proc = hello proc read; 
entry->write proc = hello proc write; 
l 


l 
/* 删 除 /proc/hello 文 件 */ 
static void hello remove Proc (void) { 
remove proc entry(HELLO DEVICE PROC NAME, NULL); 


} 
/* UBI Bi Ao Hp LR, ik P А RAAT LAE MA CBE / 
/* 初 始 化 设备 */ 
static int hello setup dev (struct hello android dev* dev) { 
int err; as ~ Е = Е 
dev_t devno = MKDEV(hello major, hello minor); 
memset (dev, 0, sizeof (struct hello android dev)); 
cdev init(&(dev-»dev), &hello fops); 
dev->dev.owner = THIS MODULE; ` 
dev->dev.ops = &hello fops; 
/* 注 册 字 符 设备 */ 
err = cdev add(&(dev-»dev),devno, 1); 
if(err) { 
return err; 


} 
/* 初 始 化 信号 量 和 寄存 器 Val 的 值 */ 
init МОТЕХ (& (dev->sem) ) ; 
dev-»val = 0; 


return 0; 
) 
/* 模 块 加 载 方 法 */ 
static int _ init hello init (void) { 
int err = -1; 


dev t dev = 0; 
struct device* temp = NULL; 
printk (KERN_ALERT" Initializing hello device.\n"); 
/* 动 态 分 配 主 设备 和 从 设备 号 */ 
err = alloc chrdev region(&dev, 0, 1, HELLO DEVICE NODE NAME); 
if(err < 0) { 
printk(KERN ALERT"Failed to alloc char dev region.\n"); 
goto fail; 
} 
hello major = MAJOR (dev); 
hello minor = MINOR (деу); 
/* 分 配 hello 设 备 结 构 体 变量 */ 
hello dev = kmalloc(sizeof(struct hello android dev), СЕР KERNEL); 
if(!hello dev) ( B c B 
err = -ENOMEM; 
printk(KERN ALERT"Failed to alloc hello_dev.\n"); 
goto unregister; 


) 
/* 初 始 化 设备 */ 
err = hello setup dev (hello dev); 
if(err) { 一 T " 
printk(KERN ALERT"Failed to setup dev: $d. Wn", err); 
goto cleanup; 


} 
/* 在 /sys/class/ 目 录 下 创建 设备 类 别 目录 hello*/ 
hello class = class create(THIS MODULE, HELLO DEVICE CLASS NAME); 
if(IS ERR(hello class)) ( Е Е Е Е 
err = PTR ERR(hello class); 
printk (KERN ALERT"Failed to create hello class.\n"); 
goto destroy cdev; 


} 
/* 在 /dev/ 目 录 和 /sys/class/hello 目 录 下 分 别 创建 设备 文件 hello*/ 
temp = device create (hello class, NULL, dev, "$s", HELLO DEVICE FILE NAME); 
if(IS ERR(temp)) ( H Е 7 
err = PTR ERR(temp); 
printk(KERN ALERT"Failed to create hello device. Wn"); 
goto destroy class; 


} 
/* 在 /sys/class/hello/hello 目 录 下 创建 属性 文件 val*/ 
err = device create file (temp, &dev attr val); 
if(err < 0) T B Ы 
printk(KERN ALERT"Failed to create attribute val.\n"); 
goto destroy_device; 
} 
dev_set drvdata (temp, hello dev); 
/*®| Ж /ргос/һе11ос Ж }}-*/ = 
hello_create_proc(); 
printk(KERN ALERT"Succedded to initialize hello device.\n"); 
return 0; 
destroy_device: 
device_destroy(hello_class, dev); 
destroy_class: 
class destroy (hello class); 
destroy cdev: 
cdev del(&(hello dev-»dev)); 


cleanup: 
kfree (hello dev); 
unregister: 
unregister chrdev region(MKDEV(hello major, hello minor), 1); 
fail: 
return err; 
} 
/* 模 块 印 载 方法 */ 


static void _ exit hello exit(void) { 
dev_t devno = MKDEV(hello major, hello minor); 
printk(KERN ALERT"Destroy hello device. Wn"); 
/* 删 除 /proc/hello 文 件 */ 
hello remove proc(); 
/* 销 毁 设备 类 别 和 设备 */ 
if(hello_class) { 
device destroy (hello class, MKDEV (hello major, hello minor)); 
class destroy (hello class); 


/* 删 除 字符 设备 和 释放 设备 内 存 */ 
if(hello dev) { 

cdev del(&(hello dev-»dev)); 

kfree (hello dev); 


} 
/* 释 放 设备 号 */ 


unregister chrdev region(devno, 1); 


} 


} 

MODULE_LICENSE ("GPL"); 

MODULE AUTHOR ("Huzhangyzn") ; 

MODULE DESCRIPTION ("First Android Driver Hello"); 
MODULE_VERSION PL Qy: 

MODULE ALIAS("A Simple Android Driver"); 
module init (hello init); module exit (hello exit); 


4. 在 hello 目 录 中 新 增 Kconfig 文 件 和 Makefile 文 件 
使 用 Kconfig 在 编译 前 执行 配置 命令 make menuconfig， 使 用 Makefile 执 行 编译 命令 make。 


Kconfig 文 件 的 内 容 如 下 : 


config HELLO 
tristate "First Android Driver" 
default n 
help 
This is the first android driver. 


Makefile 文 件 的 内 容 如 下 : 


obj-$ (CONFIG HELLO) += hello.o 


在 Kconfig 文 件 中 tristate 表 示 编 译 选项 HELLO 支 持 编译 内 核 ，hello 模 块 支持 以 模块 、 内 建 和 不 编译 三 种 编译 方法 ， 默 认 是 不 编译 。 在 编译 内 核 前 ， 需 要 执行 make menuconfig 命 令 来 配置 编译 选项 ， 
使 得 hello 以 模块 或 内 建 的 方法 进行 编译 。 


在 Makefile 文 件 中 ， 根 据 选项 HELLO 的 值 执行 不 同 的 编译 方法 。 
5. 修 改 drivers/kconfig 文 件 


在 menu"Device Drivers" 和 endmenu 之 间 添 加 一 行 代码 : 


source "drivers/hello/Kconfig" 


这 样 执行 make menuconfig 时 ， 可 以 配置 hello 模 块 的 编译 选项 。 


6. 修 改 drivers/Makefile 文 件 


添加 一 行 代码 : 


obj-$(CONFIG_HELLO) += hello/ 


7. 配 置 编译 选项 


zyhu@ubuntu-50:~/work/kernel$ make menuconfig 


找到 "Device Drivers "一 "First Android Drivers" 选 项， 设置 为 *。 


如 果 内 核 不 支持 动态 加 载 模块 ， 不 能 选择 m， 虽 然 在 Kconfig 文 件 中 配置 了 HELLO 选 项 为 tristate。 要 支持 动态 加 载 模块 选项 ， 必 须 在 配置 菜单 中 选择 Enable loadable module support 选 项 ; 要 支持 动 
态 印 载 模块 选项 ， 必 须要 在 Enable loadable module support 荣 单项 中 ， 选 择 Module unloading 选 项 。 


8. 编 译 


zyhu@ubuntu-50:~/work$ ./summon mkbootimg.sh lynx 


编译 成 功 后 ， 在 hello 目 录 下 查看 hello.o 文 件 ， 这 时 候 编译 出 来 的 boot.img 已 经 包含 了 hello 驱 动 。 


9 .测试 


将 新 kernel (boot.img) 烧 写 到 开发 板 ， 启 动机 器 ， 连 接 USB 数 据 线 。 验 证 hello 驱 动 程序 是 否 已 经 正常 安装 : 


linuxidc@www.linuxdc.com:~/Android$ adb shell 


进入 dev 目 录 ， 查 看 hello 设 备 文件 : 


root@android:/ # cd dev 
root@android:/dev # 1s 


进入 proc 目 录 ， 查 看 hello 文 件 : 


root@android:/ # cd proc 
root@android:/proc # 1s 


访问 hello 文 件 的 值 : 


root@android:/proc # cat hello 
0 


root@android:/proc # echo '5' > hello 
root@android:/proc # cat hello 
5 


进入 sys/class 目 录 ， 查 看 hello 目 录 : 


root@android:/ # cd sys/class 
root@android:/sys/class # 1s 


进入 hello 目 录 ， 查 看 hello 目 录 : 


root@android:/sys/class # cd hello 
root@android:/sys/class/hello # 1s 


进入 下 一 层 hello 目 录 ， 查 看 到 val 文 件 : 


root@android:/sys/class/hello # cd hello 


root@android:/sys/class/hello/hello # 15 


访问 属性 文件 val 的 值 : 


root@android:/sys/class/hello/hello # cat val 

9 

root@android:/sys/class/hello/hello # echo '0' > val 
root@android:/sys/class/hello/hello # cat val 

0 


至 此 已 完成 hello 内 核 驱动 程序 设计 ， 并 测试 运行 结果 。 


5.1.2 ”增加 C 硬 件 驱动 程序 


如 何 使 用 以 C 语 言 编写 的 可 执行 程序 来 访问 Linux 内 核 驱 动 程序 ， 通 过 自己 编写 的 C 可 执行 程序 来 访问 设备 文件 /dev/hello。 使 用 cat 命 令 来 直接 访问 /proc/hello 文 件 和 /sys/class/hello/hello/val 文 件 ， 
运行 驱动 程序 。 


1. 在 external 目 录 创 建 hello 目 录 


进入 Android 源 代码 工程 的 external 目 录 创建 hello 目 录 : 


zyhu@ubuntu-50:~/work$ cd external/ 
zyhu@ubuntu-50:~/work/external$ mkdir hello 


2. 在 hello 目 录 中 新 建 hello.c 文 件 


hello.c 

#include <stdio.h> 

#include <stdlib.h> 

#include <unistd.h> 

#include «fcntl.h» 

#define DEVICE NAME "/dev/hello" int main(int argc, char** argv) { 

int fd = -1; 

int val = 0; 

fd = open (DEVICE МАМЕ, O_RDWR); 

if (fd = -1) { 
printf ("Failed to open device %s.\n", DEVICE NAME); 
return -1; 

} 

printf ("Read original value:\n"); 

read(fd, &val, sizeof (val)); 

printf ("%d.\n\n", val); 

val = 5; 

printf ("Write value %d to %s.\n\n", val, DEVICE NAME); 
write(fd, &val, sizeof(val)); 

printf ("Read the value again: Wn"); 
read(fd, &val, sizeof (val)); 

printf("$d.NnWn", val); 

close (fd); 

return 0; 


} 


打开 /dev/hello 文 件 ， 先 读 出 /dev/hello 文 件 中 的 值 ， 接 着 写 入 值 5 到 /dev/hello 中 ， 最 后 再 次 读 出 /dev/hello 文 件 中 的 值 ， 查 看 是 否 刚 写 入 了 值 5。 从 /dev/hello 文 件 读 写 的 值 就 是 虚拟 的 硬件 的 寄存 器 
val 的 值 。 


3. 在 hello 目 录 中 新 建 Android.mk 文 件 


Android.mk 
LOCAL PATH := $ (call my-dir) 
include $ (CLEAR VARS) 
LOCAL MODULE TAGS := optional 
LOCAL MODULE := hello 
LOCAL SRC FILES := $(call all-subdir-c-files) 
include $(BUILD_EXECUTABLE) 


BUILD_EXECUTABLE 表 示 要 编译 的 是 可 执行 程序 。 


4. 使 用 mmm 或 者 mm 编译 


zyhu@ubuntu-50:~/work/external/hello$ mm 


编译 成 功 后 可 以 在 out/target/product/lynx/system/bin 目 录 下 查看 可 执行 文件 hello。 


5. 重 新 打包 Android 系 统 文件 system.img 


zyhu@ubuntu-50:~/work$ ./summon mkext4img.sh lynx system 


中 


新 打包 后 的 system.img 文 件 会 包含 刚才 编译 好 的 hello 可 执行 文件 。 


6 .测试 


将 新 system (system.img) 烧 写 到 开发 板 ， 启 动机 器 ， 使 用 /system/bin/hello 可 执行 程序 来 访问 Linux 内 核 驱动 程序 。 


root@android:/ # cd system/bin 
root@android:/system/bin # ./hello 
Read the original value: 
Qs 
Write value 5 to /dev/hello. 
Read the value again: 
Dis 


查看 运行 结果 ， 说 明 编 写 的 C 可 执行 程序 可 以 访问 Linux 内 核 驱动 程序 。 


5.1.3 ”接口 硬件 驱动 程序 


Android 的 应 用 程序 是 用 Java 语 言 编写 的 ， 能 不 能 在 Android 的 Application Frameworks 提 供 Java 接 口 来 访问 Linux 内 核 驱动 程序 呢 ? 这 一 节 将 介绍 如 何在 硬件 抽象 层 中 增加 硬件 模块 来 四 内 核 驱动 程序 
交互 ， 以 及 在 Android 系 统 创建 设备 文件 时 用 类 似 Linux 的 udev 规 则 修改 设备 文件 模式 的 方法 。 


1. 新 建 hello 目 录 


内 核 驱动 程序 在 Android 系 统 中 得 到 三 个 文件 ， 分 别 是 /dewhello、/sys/class/hello/hello/val 和 /proc/hello。 将 通过 设备 文件 /dewhello 来 连接 硬件 抽象 层 模 块 和 Linux 内 核 驱 动 程序 模块 。 


2. 新 建 hello.h 文 件 


进入 在 hardware/libhardware/include/hardware 目 录 ， 新 建 hello.h 文 件 : 


zyhu@ubuntu-50:~/work$ cd hardware/libhardware/include/hardware/ 
zyhu@ubuntu-50:~/work/hardware/libhardware/include/hardware$ vim hello.h 
hello.h 
#ifndef ANDROID HELLO INTERFACE H 
#define ANDROID HELLO INTERFACE H 
dinclude «hardware/hardware.h» ` 

BEGIN DECLS 
7* SAE ID* / 
#define HELLO HARDWARE MODULE ID "hello" 
/* 硬 件 模块 结构 体 */ 

struct hello_module_t { 

struct hw module t common; 


1; 
/* 硬 件 接口 结构 体 */ 
struct hello device t { 
struct hw device t common; 
int fd; 
int (*set val) (struct hello device t* dev, int val); 
int (*get val) (struct hello device t* dev, int* val); 
1; 
END DECLS 
Тепаіғ 


按照 Android 硬 件 抽象 层 规范 的 要 求 ， 分 别 定义 模块 ID、 模 块 结构 体 以 及 硬件 接口 结构 体 。 在 硬件 接口 结构 体 中 fd 表示 设备 文件 描述 符 ， 对 应 将 要 处 理 的 设备 文件 /dewWhello"，set_val 和 get_ маі 
HAL 提 供 的 函数 接口 。 


3. 添 加 hello.c 文 件 


进入 hardware/libhardware/modules 目 录 ， 新 建 hello 目 录 ， 并 添加 hello.c 文 件 。 


zyhu@ubuntu-50:~/work/hardware/libhardware/modules$ mkdir hello 
zyhu@ubuntu-50: ~/work/hardware/libhardware/modules/hello$ vim hello.c 
hello.c 
/* 首 先是 包含 相关 头 文件 和 定义 相关 结构 */ 
#define LOG TAG "HelloStub" 
#include «hardware/hardware.h» 
#include <hardware/hello.h> 
#include <fcntl.h> 
#include <errno.h> 
#include <cutils/log.h> 
#include <cutils/atomic.h> 
#define DEVICE NAME "/dev/hello" 
#define MODULE NAME "Hello" 
#define MODULE AUTHOR "shyluo@gmail.com" 
/* 设 备 打开 和 关闭 接口 */ 
static int hello device open (const struct hw module t* module, const char* name, struct hw device t** device); 
static int hello device close(struct hw device t* device); = » 
/* 设 备 访问 接口 */ 
static int hello set val(struct hello device t* dev, int val); static int hello get val(struct hello device t* dev, int* val); 
/* 模 块 方法 表 */ 
static struct hw module methods t hello module methods = { 
open: hello device open Е 
1; 
/* 模 块 实例 变量 */ 
struct hello module t HAL MODULE INFO SYM = ( 
common: { 一 i - Е 
tag: HARDWARE MODULE TAG, 
version major: 1, ` 
version minor: 0, 
id: HELLO HARDWARE MODULE ID, 
name: MODULE МАМЕ, Е 
author: MODULE AUTHOR, 
methods: &hello module methods, 
Í 
1: 
/* 实 例 变量 名 必须 为 HAL MODULE INFO_SYM，tag 也 必须 为 HARDNRARE MODULE TARG， 这 是 Android 硬 件 抽象 层 规范 规定 */ 
/* Ж hello device openiZt*/ 7 m Е 
static int hello_device_open (const struct hw module t* module, const char* name, struct hw device t** device) { 
struct hello device t* dev;dev = (struct hello device t*)malloc(sizeof (struct hello device t)); 
if(!dev) ( 
LOGE("Hello Stub: failed to alloc space"); 
return -EFAULT; 
} 
memset (dev, 0, sizeof (struct hello device t)); 
dev-»common.tag = HARDWARE DEVICE TAG; 
dev-»common.version = 0; “` = 
dev-»common.module = (hw module t*)module; 
dev-»common.close = hello device close; 
dev-»set val = hello set val; dev-»get val = hello get val; 
if ((dev->fd = open(DEVICE NAME, О RDWR)) == -1) í 
LOGE ("Hello Stub: failed to open /dev/hello -- $s.", strerror (errno) ) ; free (dev); 
return -EFAULT; 


} 

*device = &(dev->common) ; 

LOGI ("Hello Stub: open /dev/hello successfully."); 
return 0; 


} 
/* 定 义 hello device close. hello set val 和 hello_ get _ val 函数 */ 
static int hello device close(struct hw device t* device) { 
struct hello device t* hello device = (struct hello device t*)device; 
if(hello device) ( 
close (hello device->fd) ; 
free (hello device); 
} 
return 0; 
$ 
static int hello set val(struct hello device t* dev, int val) { 
LOGI("Hello Stub: set value $d to device.", val); 
write (dev->fd, &val, sizeof(val)); 
return 0; 
} 
static int hello_get_val(struct hello_device_t* dev, int* val) { 
if(!val) ( 
LOGE("Hello Stub: error val pointer"); 
return -EFAULT; 
} 


read(dev->fd, val, sizeof (*val)); 


LOGI ("Hello Stub: get value %d from device", *val); 
return 0; 


4. 在 hello 目 录 下 新 建 Android.mk 文 件 


Android.mk 

LOCAL_PATH := $(call my-dir) 

include $(CLEAR VARS) 

LOCAL MODULE TAGS 
LOCAL PRELINK MODULE false 

LOCAL MODULE PATH :- $(TARGET OUT SHARED LIBRARIES) /hw 
LOCAL SHARED LIBRARIES := liblog ` Е 

LOCAL SRC FILES := hello.c LOCAL MODULE := hello.default 

include S$(BUILD SHARED LIBRARY) ~ 


optional 


根据 LOCAL MODULE 的 定义 规则 可 知 : hello 后 面 跟 有 default，hello.default 能 够 保证 模块 总 能 被 硬件 抽象 层 加 载 。 


5. 编 译 


zyhu@ubuntu-50:~/work/hardware/libhardware/modules/hello$ mm 


编译 成 功 后 ， 在 out/target/product/lynx/system/lib/hw/ 目 录 下 能 查看 到 hello.default.so 文 件 。 


6. 重 新 打包 Android 系 统 镜像 system.img 


zyhu@ubuntu-50:~/work$ ./summon mkext4img.sh lynx system 


新 打包 后 ，system.img 就 包含 定义 的 硬件 抽象 层 模 块 hello.default。 


5.1.4 ”J 改 | 醒 件 驱 动 程序 


hi 


虽然 在 Android 系 统 中 为 硬件 增加 了 一 个 硬件 抽象 层 模块 ， 但 是 Java 应 用 程序 还 不 能 访问 硬件 ， 还 必须 编写 JN1 方 法 并 在 Android 的 Application Frameworks 层 增加 API 接 口 ， 才 能 让 上 层 Application 访 
问 硬件 。Java 提 供 了 JINI 调 用 方法 ， 使 用 Android 硬 件 抽象 层 接口 编写 JNI 方 法 ， 在 Android 系 统 中 Java 应 用 程序 通过 JNl 来 调用 硬件 抽象 层 接口 ， 使 得 上 层 的 Java 应 用 程序 能 够 使 用 下 层 提 供 的 硬件 服务 。 


1. 新 建 com_android_server_HelloService.cpp 文 件 


进入 frameworks/base/services/jni 目 录 新 建 cCom_android_server_HelloService.cpp 文 件 。 


zyhu@ubuntu-50:~/work/frameworks/base/services/jni$ 
vim com android server HelloService.cpp 


在 com_android_server_HelloService.cpp 文 件 中 实现 JN| 方 法 。com_android_server 前 缀 表示 的 是 包 名 ， 表 示 硬 件 服务 HelloService 是 放 在 frameworks/base/services/java 目 录 下 的 
com/android/server 目 录 ， 即 存在 一 个 命名 为 com.android.server.HelloService 的 类 。HelloService 是 一 个 提供 Java 接 口 的 硬件 访问 服务 类 。 


com android server HelloService.cpp 
/* 首先 应 包含 相应 的 头 文件 */ 
#define LOG TAG "HelloService" 
#include "jni.h" 
#include "JNIHelp.h" 
#include "android runtime/AndroidRuntime.h" 
#include <utils/misc.h> 
#include <utils/Log.h> 
#include <hardware/hardware.h> 
#include <hardware/hello.h> 
#include <stdio.h> 
/* 接着 定义 hello init. hello getValfehello setVal 这 三 个 JNI 方 法 */ 
namespace android  ( ur > 
/* 在 硬件 抽象 层 中 定义 的 硬件 访问 结构 体 ， 参 考 <hardware/hello.h>*/ 
struct hello device t* hello device = NULL; 
/* 通 过 硬件 抽象 层 定义 的 硬件 访问 接口 设置 硬件 寄存 器 Val 的 值 */ 
static void hello setVal(JNIEnv* env, jobject clazz, jint value) { 
int val = value; 
LOGI ("Hello JNI: set value $d to device.", val); 
if(!hello device) ( 
LOGI("Hello JNI: device is not open."); 
return; 


hello device-»set val(hello device, val); 


l 
/* 通 过 硬件 抽象 层 定义 的 硬件 访问 接口 读 取 硬件 寄存 器 val 的 值 */ 
static jint hello_getVal(JNIEnv* env, jobject clazz) { 
int val = 0; 
if(!hello device) ( 
LOGI("Hello JNI: device is not open."); 
return val; 


hello device-»get val (hello device, &val); 
LOGI("Hello JNI: get value $d from device.", val); 
return val; 


} 
/* 通 过 硬件 抽象 层 定义 的 硬件 模块 打开 接口 打开 硬件 设备 */ 
int hello device open(const hw module t* module, struct hello device t** device) { 
return module-»methods-»open (module, HELLO HARDWARE MODULE ID, (struct hw device t**)device); 


) 

/* 通 过 硬件 模块 TD 来 加 载 指定 的 硬件 抽象 层 模 块 并 打开 硬件 */ 
static bool hello init(JNIEnv* env, jclass clazz) { 
hello module t* module; 


LOGI ("Hello JNI: initializinghttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/ . .http: / /www.hzcourse.com/resource/readE 


if(hw get module(HELLO HARDWARE MODULE ID, (const struct hw module t**)&module) == 0) { 
LOGI("Hello JNI: hello Stub found."); 
if(hello device open(&(module-»common), &hello device) == 0) ( 
LOGI("Hello JNI: hello device is open."); 
return 0; 


) 
LOGE("Hello JNI: failed to open hello device."); 
return -1; 


l 
LOGE("Hello JNI: failed to get hello stub module."); 
return -1; 


) 
/*JNI 方 法 表 */ 


static const JNINativeMethod method table[] = ( 
("init native", "()Z", (void*)hello init), 
("setVal native", "(I)V", (void*)hello setVal}, 
("getVal native", "()I", (void*)hello getVal) 


}; 
/* 注 册 JNI 方 法 */ 


int register android server HelloService(JNIEnv *env) { 
return jniRegisterNativeMethods (env, "com/android/server/HelloService", method _ 


table, NELEM(method table)); 
} 
H 


在 hello_init 函 数 中 通过 Android 硬 件 抽象 层 提供 的 hw_get_module 方 法 来 加 载 模块 ID 为 HELLO_HARDWARE_MODULE ID 的 硬件 抽象 层 模块 ， 其 中 HELLO_HARDWARE_MODULE ID 是 在 


<hardware/hello.h> 中 定义 的 。Android 硬 件 抽象 层 根据 HELLO_HARDWARE_MODULE ID 的 值 在 Android 系 统 的 /systemylib/hw 目 录 中 找到 相应 的 模块 进行 加 载 ， 并 且 返 回 hw_module t 接 口 给 调用 者 
使 用 。 在 jniRegisterNativeMethods 函 数 中 的 第 二 个 参数 的 值 必须 对 应 HelloService 所 在 的 包 的 路 径 ， 即 com.android.server.Helloservice。 


2. 修 改 同 目录 下 的 onload.cpp 文 件 


首先 在 namespace android 中 增加 register android_server_Helloservice 函 数 声明 : 


namespace android { 


ttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
int register android server HelloService(JNIEnv *env) ; 


H 


在 JNI_onLoad 中 增加 register android server_Helloservice 函 数 调用 : 


F 


extern "C" jint JNI_onLoad(JavaVM* vm, void* reserved) { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 


register_android_server_HelloService (env) ; 


} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 


在 Android 系 统 初始 化 时 ， 自 动 加 载 该 JNI 方 法 调用 表 。 


3. 修 改 同 目 录 下 的 Android.mk 文 件 


在 LOCAL_SRC_FILES 变 量 中 增加 如 下 代码 : 


LOCAL_SRC_FILES:= \ 

com_android_server AlarmManagerService.cpp \ 
com android server BatteryService.cpp Ñ 

com android server KeyInputQueue.cpp V 

com android server LightsService.cpp V 

com android server SensorService.cpp \ 

com android server SystemServer.cpp 

com android server VibratorService.cpp \ 
com android server HelloService.cpp V 
onload.cpp Е 


4 编译 和 重新 打包 system.img 


zyhu@ubuntu-50:~/work/frameworks/base/services/jni$ mm zyhu@ubuntu-50:~/work$ ./summon mkext4img.sh lynx system 


第 5 章 ”系统 硬件 与 驱动 程序 


5.1 Android 硬 件 抽 象 层 (HAL) 


Android 的 硬件 抽象 层 是 对 Linux 内 核 驱动 程序 的 封装 ， 


向 上 提供 接口 ， 屏 蔽 低层 


Linux 内 核 驱 动 程序 运行 在 内 核 空间 。Android 硬 件 抽象 层 如 


图 5-1 所 示 。 


重新 打包 的 system.img 镜 像 文件 包含 刚才 编写 的 JNI 方 法 ， 通 过 Android 系 统 的 Application Frameworks 层 提供 的 硬件 服务 HelloService 来 调用 这 些 JNI 方 法 ， 进 而 实现 调用 低层 的 硬件 抽象 层 接口 去 访 
问 硬件 。 


的 硬件 。 把 对 硬件 的 支持 分 成 了 两 


NI 


一 层 放 在 用 户 空间 ， 另 一 层 放 在 内 核 空间 。 硬 件 抽象 层 运行 在 用 户 空间 ， 而 


Android 硬 件 抽象 层 由 Android 系 统 的 硬件 驱动 层 、 硬 件 抽象 层 、 运 行 时 库 和 应 和 


访问 硬件 ， 在 系统 启动 时 提供 硬件 访问 服务 ， 以 及 编写 JNI 通 过 Java 接 口 来 访问 硬件 。 


程序 框架 层 等 组 成 。 通 过 学 习 Android 硬 件 抽象 层 ， 了 解 在 内 核 空间 编写 硬件 驱动 程序 ， 在 硬件 抽象 层 中 添加 接口 支持 
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图 5-1 ”Android 硬件 抽象 层 


5.1.1 内核 硬件 驱动 程序 


Android 系 统 编写 内 核 驱动 程序 使 用 一 个 虚拟 的 硬件 设备 ， 这 个 设备 只 有 一 个 4 字 节 的 寄存 器 ， 对 寄存 器 可 以 进行 读 写 操作 。 把 这 


序 。Android 内 核 驱动 程序 和 一 般 Linux 内 核 驱动 程序 的 编写 方法 相同 ， 这 里 从 Android 系 统 的 角度 来 描述 Android 内 核 驱动 程序 的 编写 和 编译 过 程 。 


1. 在 kernel/drivers 目 录 新 建 hello 目 录 


个 虚拟 的 设备 命名 为 “hello” 


， 而 内 核 驱 动 程序 也 命名 为 hello 驱 动 程 


zyhu@ubuntu-50:~/work/kernel$ cd drivers/ 
zyhu@ubuntu-50:~/work/kernel/drivers$ mkdir hello 


2. 在 hello 目 录 中 增加 hello.h 文 件 


hello.h 
#ifndef HELLO ANDROID H 
#define HELLO 2 ) ANDROID H` 
#include <linux/cdev.h> 
#include <linux/semaphore.h> 
#define HELLO DEVICE NODE NAME "hello" 
#define HELIO DEVICE FILE NAME "hello" 
#define HELIO DEVICE PROC NAME "hello" 
#define HELLO DEVICE CLASS NAME "hello" 
struct hello_android dev ( 

int val; 

struct semaphore sem; 

struct cdev dev; 
1; 
#епаіғ 


在 hello.h 头 文件 中 定义 了 一 些 字符 串 常量 宏 ， 并 定义 了 一 个 字符 设备 结构 体 hello_android_dev， 对 应 虚拟 的 硬件 设备 ，val 成 员 
定义 字符 设备 结构 体 的 标准 方法 。 


号 量 ， 用 同步 访问 寄存 器 val，dev 成 员 变 量 是 一 个 内 嵌 的 字符 设备 ， 这 就 是 Linux 驱 动 程序 


3. 在 hello 目 录 中 增加 hello.c 文 件 


变量 就 代表 设备 里 


H 


的 寄存 器 


， 它 的 类 型 为 int，sem 成 员 


=== 
TOSSES: 


是 一 个 信 


驱动 程序 的 功能 主要 是 向 上 层 提供 访问 设备 的 寄存 器 的 值 ， 包 括 读 和 写 操作 。 驱 动 程序 提供 了 三 种 访问 设备 寄存 器 的 方法 ， 一 是 通过 proc 文 件 系统 来 访问 ， 二 是 通过 传统 的 设备 文件 的 方法 来 访问 ， 三 


是 通过 devfs 文 件 系统 来 访问 。 下 面 是 驱动 程序 的 代码 : 


Hello.c 

/* 包 含 必要 的 头 文件 和 定义 三 种 访问 设备 的 方法 */ 

finclude <linux/init.h> 
#include <linux/module.h> 
#include <linux/types.h> 

finclude «linux/fs.h» 

#include «linux/proc fs.h» 

#include «linux/device.h» 
#include «asm/uaccess.h» 
#include "hello.h" 

/* 主 设备 和 从 设备 号 变量 */ 


static int hello major = 0; 


static int hello minor = 0; 

/* 设 备 类 别 和 设备 变量 */ 
static struct class* hello class = NULL; 
static struct hello ' android dev* hello dev = NULL; 

/* 传 统 的 设备 文件 操作 方法 */ 
static int hello open(struct inode* inode, struct file* filp); 
static int hello_release(struct inode* inode, struct file* filp); š 
static ssize_t hello_read(struct file* filp, char _user *buf, size t count, loff t* f pos); 
static ssize t hello: ) write(struct file* filp, const char _user *buf, size t count, loff t* f pos); 
/* 设 备 文件 操作 方法 表 */ 
static struct file operations hello fops = ( 

.owner = THIS MODULE, 

.open = hello open, 

.release = hello release, 
.read = hello read, 

.write = hello write, 


1; 
/* 访 问 设置 属性 方法 */ 
static ssize_t hello_val_show(struct device* dev, struct device_attribute* attr, char* buf); 
eee ssize t hello ^ val | . Store(struct device* dev, struct device | attribute* attr, const char* buf, size t count); 
定义 设备 属性 */ 
decr DEVICE ATTR(val, S IRUGO | S IWUSR, hello val show, hello val store); 
/* 定义 传统 的 设备 文件 访问 方法 ， 主 要 是 定义 hello open, hello release、hello read 和 hello_write 这 4 个 打开 、 释 放 、 读 和 写 设备 文件 的 方法 */ 
/* 打 开设 备 方法 */ 
static int hello open(struct inode* inode, struct file* filp) Í 
struct hello ао as up: dev; 
/* 将 自 定义 设备 结构 体 保存 在 文件 指针 的 私有 数据 域 中 ， 以 便 访 问 设备 时 使 用 */ 
dev = container of(inode-»i cdev, struct hello android dev, dev); 
filp-»private data - dev; 
return 0; T 
/* 设 备 文件 释放 时 调用 ， 空 实现 */ 
static int hello release(struct inode* inode, struct file* filp) { 
return 0; 


l 
/* 读 取 设 备 的 寄存 器 Val 的 值 */ 
static ssize t hello read(struct file* filp, char _ user *buf, size t count, loff_t* f pos) { 
ssize t err = 0; 
struct hello | android_dev* dev = filp->private_data; 
/* 同 步 访问 */ 
if (down_interruptible(&(dev->sem))) { 
return -ERESTARTSYS; 
} 
if(count < sizeof (dev->val)) { 


goto out; 
} 
/* 将 寄存 器 val 的 值 复制 到 用 户 提供 的 缓冲 区 */ 
if(copy to user(buf, &(dev->val), sizeof(dev-»val))) { 
err = -EFAULT; 
goto out; 


err = sizeof (dev-»val); 
out: 

up (& (dev-»sem)); 
return err; 


/* 写 设备 的 寄存 器 值 val*/ 
static ssize t hello write(struct file* filp, const char _ user *buf, size t count, loff t* f pos) { 
struct hello android dev* dev = filp-»private data; 
ssize t err = 0; 
/* 同 步 访问 */ 
if (down_interruptible(&(dev->sem))) { 
return -ERESTARTSYS; 


if(count != sizeof(dev-»val)) { 
goto out; 


š 
/* 将 用 户 提供 的 缓冲 区 的 值 写 到 设备 寄存 器 中 */ 
if(copy from user(&(dev-»val), buf, count)) { 
err = -EFAULT; 
goto out; 
] 
err = sizeof (dev-»val); 
out: 
up (& (dev->sem) ) ; return err; 


l 
/* 定义 通过 devfs 文 件 系 统 访问 方法 ， 把 设备 的 寄存 器 Val 看 成 是 设备 的 一 个 属性 ， 通 过 读 写 这 个 属性 来 对 设备 进行 访问 ,主要 是 实现 hello_val_show 和 hello_val_store 两 个 方法 ， 同 时 定义 了 两 个 内 部 使 用 的 访问 val 值 的 方 
/* 读 取 寄存 器 val 的 值 到 缓冲 区 buf 中 ， 内 部 使 用 */ 
static ssize t _ hello get val(struct hello android dev* dev, char* buf) { 

int val = 0; 

/* 同 步 访问 */ 

if (down interruptible(& (dev->sem))) { 
return -ERESTARTSYS; 


val = dev-»val; 
up (& (dev->sem) ) ; 
return snprintf (buf, PAGE SIZE, "Sd\n", val); 
} 
/* 把 缓冲 区 buf 的 值 写 到 设备 寄存 器 val 中 去 ， 内 部 使 用 */ 
static ssize t _ hello set val(struct hello android dev* dev, const char* buf, size t count) { 
int val = 0; 
/* 将 字符 串 转换 成 数字 */ 
val = simple strtol (buf, NULL, 10); 
/* 同 步 访问 */ 
if (down interruptible (&(dev-»sem))) { 
return -ERESTARTSYS; 
) 
dev-»val = val; 
up (& (dev-»sem)) ; 
return count; 


} 
/* 读 取 设 备 属性 val*/ 
static ssize t hello val show(struct device* dev, struct device attribute* attr, char* buf) { 
struct hello ; android dev* hdev = (struct hello android | dev*) dev ' get. drvdata (деу); 
return . hello | get val(hdev, buf); 


} 
/* 写 设备 属性 val*/ 
static ssize t hello val store(struct device* dev, struct device attribute* attr, const char* buf, size t count) { 
struct hello ; android « dev* hdev = (struct hello android dev*)dev ' get « drvdata (dev) ; 
return . hello | set . val (hdev, buf, count); 


定义 通过 proc 文 件 系统 访问 方法 ， 主 要 实现 了 he1L1o proc readfehello proc write 两 个 方法 ， 同 时 定义 了 在 proc 文 件 系 统 创建 和 删除 文件 的 方法 hello_create_proc 和 hello_remove proc*/ 
a 保存 在 page 缓 冲 区 中 * / 
static ssize t hello proc read(char* page, char** start, off t off, int count, int* eof, void* data) { 
if(off » 0) ( 
*eof = 1; 
return 0; 


} 
return _ hello get val(hello dev, page); 


} 
/* 把 缓冲 区 的 值 buff 保 存 到 设备 寄存 器 val 中 */ 
static ssize_t hello_proc_write(struct file* filp, const char _ user *buff, unsigned long len, void* data) { 
int err = 0; 
char* page = NULL; 
if(len > PAGE_SIZE) { 
printk (KERN ALERT"The buff is too large: %lu.\n", len); 
return -EFAULT; 
} 
page = (char*) get free page(GFP KERNEL); 
f(page) { 
printk(KERN ALERT"Failed to alloc page. Wn"); 
return -ENOMEM; 


/二 把 用 户 提供 的 组 站 区 值 复制 到 到 内 核 缓冲 区 中 */ 

if(copy from user(page, buff, len)) { 
printk(KERN ALERT"Failed to copy buff from user.\n"); 
err = -EFAULT; 
goto out; 

} 

err = hello set val(hello dev, page, len); 


out: 
free page ( (unsigned long) page) ; 
return err; 


l 
/* 创 建 /proc/hello 文 件 */ 
static void hello create proc(void) { 
struct proc dir entry* entry; 
entry = create proc entry (HELLO DEVICE PROC NAME, 0, NULL); 
if(entry) { 
entry->read proc = hello proc read; 
entry->write proc = hello proc write; 
l 


l 
/* 删 除 /proc/hello 文 件 */ 
static void hello remove Proc (void) { 
remove proc entry(HELLO DEVICE PROC NAME, NULL); 


} 
/* UBI Bi Ao Hp LR, ik P А RAAT LAE MA CBE / 
/* 初 始 化 设备 */ 
static int hello setup dev (struct hello android dev* dev) { 
int err; as ~ Е = Е 
dev_t devno = MKDEV(hello major, hello minor); 
memset (dev, 0, sizeof (struct hello android dev)); 
cdev init(&(dev-»dev), &hello fops); 
dev->dev.owner = THIS MODULE; ` 
dev->dev.ops = &hello fops; 
/* 注 册 字 符 设备 */ 
err = cdev add(&(dev-»dev),devno, 1); 
if(err) { 
return err; 


} 
/* 初 始 化 信号 量 和 寄存 器 Val 的 值 */ 
init МОТЕХ (& (dev->sem) ) ; 
dev-»val = 0; 


return 0; 
) 
/* 模 块 加 载 方 法 */ 
static int _ init hello init (void) { 
int err = -1; 


dev t dev = 0; 
struct device* temp = NULL; 
printk (KERN_ALERT" Initializing hello device.\n"); 
/* 动 态 分 配 主 设备 和 从 设备 号 */ 
err = alloc chrdev region(&dev, 0, 1, HELLO DEVICE NODE NAME); 
if(err < 0) { 
printk(KERN ALERT"Failed to alloc char dev region.\n"); 
goto fail; 
} 
hello major = MAJOR (dev); 
hello minor = MINOR (деу); 
/* 分 配 hello 设 备 结 构 体 变量 */ 
hello dev = kmalloc(sizeof(struct hello android dev), СЕР KERNEL); 
if(!hello dev) ( B c B 
err = -ENOMEM; 
printk(KERN ALERT"Failed to alloc hello_dev.\n"); 
goto unregister; 


) 
/* 初 始 化 设备 */ 
err = hello setup dev (hello dev); 
if(err) { 一 T " 
printk(KERN ALERT"Failed to setup dev: $d. Wn", err); 
goto cleanup; 


} 
/* 在 /sys/class/ 目 录 下 创建 设备 类 别 目录 hello*/ 
hello class = class create(THIS MODULE, HELLO DEVICE CLASS NAME); 
if(IS ERR(hello class)) ( Е Е Е Е 
err = PTR ERR(hello class); 
printk (KERN ALERT"Failed to create hello class.\n"); 
goto destroy cdev; 


} 
/* 在 /dev/ 目 录 和 /sys/class/hello 目 录 下 分 别 创建 设备 文件 hello*/ 
temp = device create (hello class, NULL, dev, "$s", HELLO DEVICE FILE NAME); 
if(IS ERR(temp)) ( H Е 7 
err = PTR ERR(temp); 
printk(KERN ALERT"Failed to create hello device. Wn"); 
goto destroy class; 


} 
/* 在 /sys/class/hello/hello 目 录 下 创建 属性 文件 val*/ 
err = device create file (temp, &dev attr val); 
if(err < 0) T B Ы 
printk(KERN ALERT"Failed to create attribute val.\n"); 
goto destroy_device; 
} 
dev_set drvdata (temp, hello dev); 
/*®| Ж /ргос/һе11ос Ж }}-*/ = 
hello_create_proc(); 
printk(KERN ALERT"Succedded to initialize hello device.\n"); 
return 0; 
destroy_device: 
device_destroy(hello_class, dev); 
destroy_class: 
class destroy (hello class); 
destroy cdev: 
cdev del(&(hello dev-»dev)); 


cleanup: 
kfree (hello dev); 
unregister: 
unregister chrdev region(MKDEV(hello major, hello minor), 1); 
fail: 
return err; 
} 
/* 模 块 印 载 方法 */ 


static void _ exit hello exit(void) { 
dev_t devno = MKDEV(hello major, hello minor); 
printk(KERN ALERT"Destroy hello device. Wn"); 
/* 删 除 /proc/hello 文 件 */ 
hello remove proc(); 
/* 销 毁 设备 类 别 和 设备 */ 
if(hello_class) { 
device destroy (hello class, MKDEV (hello major, hello minor)); 
class destroy (hello class); 


/* 删 除 字符 设备 和 释放 设备 内 存 */ 
if(hello dev) { 

cdev del(&(hello dev-»dev)); 

kfree (hello dev); 


} 
/* 释 放 设备 号 */ 


unregister chrdev region(devno, 1); 


} 


} 

MODULE_LICENSE ("GPL"); 

MODULE AUTHOR ("Huzhangyzn") ; 

MODULE DESCRIPTION ("First Android Driver Hello"); 
MODULE_VERSION PL Qy: 

MODULE ALIAS("A Simple Android Driver"); 
module init (hello init); module exit (hello exit); 


4. 在 hello 目 录 中 新 增 Kconfig 文 件 和 Makefile 文 件 
使 用 Kconfig 在 编译 前 执行 配置 命令 make menuconfig， 使 用 Makefile 执 行 编译 命令 make。 


Kconfig 文 件 的 内 容 如 下 : 


config HELLO 
tristate "First Android Driver" 
default n 
help 
This is the first android driver. 


Makefile 文 件 的 内 容 如 下 : 


obj-$ (CONFIG HELLO) += hello.o 


在 Kconfig 文 件 中 tristate 表 示 编 译 选项 HELLO 支 持 编译 内 核 ，hello 模 块 支持 以 模块 、 内 建 和 不 编译 三 种 编译 方法 ， 默 认 是 不 编译 。 在 编译 内 核 前 ， 需 要 执行 make menuconfig 命 令 来 配置 编译 选项 ， 
使 得 hello 以 模块 或 内 建 的 方法 进行 编译 。 


在 Makefile 文 件 中 ， 根 据 选项 HELLO 的 值 执行 不 同 的 编译 方法 。 
5. 修 改 drivers/kconfig 文 件 


在 menu"Device Drivers" 和 endmenu 之 间 添 加 一 行 代码 : 


source "drivers/hello/Kconfig" 


这 样 执行 make menuconfig 时 ， 可 以 配置 hello 模 块 的 编译 选项 。 


6. 修 改 drivers/Makefile 文 件 


添加 一 行 代码 : 


obj-$(CONFIG_HELLO) += hello/ 


7. 配 置 编译 选项 


zyhu@ubuntu-50:~/work/kernel$ make menuconfig 


找到 "Device Drivers "一 "First Android Drivers" 选 项， 设置 为 *。 


如 果 内 核 不 支持 动态 加 载 模块 ， 不 能 选择 m， 虽 然 在 Kconfig 文 件 中 配置 了 HELLO 选 项 为 tristate。 要 支持 动态 加 载 模块 选项 ， 必 须 在 配置 菜单 中 选择 Enable loadable module support 选 项 ; 要 支持 动 
态 印 载 模块 选项 ， 必 须要 在 Enable loadable module support 荣 单项 中 ， 选 择 Module unloading 选 项 。 


8. 编 译 


zyhu@ubuntu-50:~/work$ ./summon mkbootimg.sh lynx 


编译 成 功 后 ， 在 hello 目 录 下 查看 hello.o 文 件 ， 这 时 候 编译 出 来 的 boot.img 已 经 包含 了 hello 驱 动 。 


9 .测试 


将 新 kernel (boot.img) 烧 写 到 开发 板 ， 启 动机 器 ， 连 接 USB 数 据 线 。 验 证 hello 驱 动 程序 是 否 已 经 正常 安装 : 


linuxidc@www.linuxdc.com:~/Android$ adb shell 


进入 dev 目 录 ， 查 看 hello 设 备 文件 : 


root@android:/ # cd dev 
root@android:/dev # 1s 


进入 proc 目 录 ， 查 看 hello 文 件 : 


root@android:/ # cd proc 
root@android:/proc # 1s 


访问 hello 文 件 的 值 : 


root@android:/proc # cat hello 
0 


root@android:/proc # echo '5' > hello 
root@android:/proc # cat hello 
5 


进入 sys/class 目 录 ， 查 看 hello 目 录 : 


root@android:/ # cd sys/class 
root@android:/sys/class # 1s 


进入 hello 目 录 ， 查 看 hello 目 录 : 


root@android:/sys/class # cd hello 
root@android:/sys/class/hello # 1s 


进入 下 一 层 hello 目 录 ， 查 看 到 val 文 件 : 


root@android:/sys/class/hello # cd hello 


root@android:/sys/class/hello/hello # 15 


访问 属性 文件 val 的 值 : 


root@android:/sys/class/hello/hello # cat val 

9 

root@android:/sys/class/hello/hello # echo '0' > val 
root@android:/sys/class/hello/hello # cat val 

0 


至 此 已 完成 hello 内 核 驱动 程序 设计 ， 并 测试 运行 结果 。 


5.1.2 ”增加 C 硬 件 驱动 程序 


如 何 使 用 以 C 语 言 编写 的 可 执行 程序 来 访问 Linux 内 核 驱 动 程序 ， 通 过 自己 编写 的 C 可 执行 程序 来 访问 设备 文件 /dev/hello。 使 用 cat 命 令 来 直接 访问 /proc/hello 文 件 和 /sys/class/hello/hello/val 文 件 ， 
运行 驱动 程序 。 


1. 在 external 目 录 创 建 hello 目 录 


进入 Android 源 代码 工程 的 external 目 录 创建 hello 目 录 : 


zyhu@ubuntu-50:~/work$ cd external/ 
zyhu@ubuntu-50:~/work/external$ mkdir hello 


2. 在 hello 目 录 中 新 建 hello.c 文 件 


hello.c 

#include <stdio.h> 

#include <stdlib.h> 

#include <unistd.h> 

#include «fcntl.h» 

#define DEVICE NAME "/dev/hello" int main(int argc, char** argv) { 

int fd = -1; 

int val = 0; 

fd = open (DEVICE МАМЕ, O_RDWR); 

if (fd = -1) { 
printf ("Failed to open device %s.\n", DEVICE NAME); 
return -1; 

} 

printf ("Read original value:\n"); 

read(fd, &val, sizeof (val)); 

printf ("%d.\n\n", val); 

val = 5; 

printf ("Write value %d to %s.\n\n", val, DEVICE NAME); 
write(fd, &val, sizeof(val)); 

printf ("Read the value again: Wn"); 
read(fd, &val, sizeof (val)); 

printf("$d.NnWn", val); 

close (fd); 

return 0; 


} 


打开 /dev/hello 文 件 ， 先 读 出 /dev/hello 文 件 中 的 值 ， 接 着 写 入 值 5 到 /dev/hello 中 ， 最 后 再 次 读 出 /dev/hello 文 件 中 的 值 ， 查 看 是 否 刚 写 入 了 值 5。 从 /dev/hello 文 件 读 写 的 值 就 是 虚拟 的 硬件 的 寄存 器 
val 的 值 。 


3. 在 hello 目 录 中 新 建 Android.mk 文 件 


Android.mk 
LOCAL PATH := $ (call my-dir) 
include $ (CLEAR VARS) 
LOCAL MODULE TAGS := optional 
LOCAL MODULE := hello 
LOCAL SRC FILES := $(call all-subdir-c-files) 
include $(BUILD_EXECUTABLE) 


BUILD_EXECUTABLE 表 示 要 编译 的 是 可 执行 程序 。 


4. 使 用 mmm 或 者 mm 编译 


zyhu@ubuntu-50:~/work/external/hello$ mm 


编译 成 功 后 可 以 在 out/target/product/lynx/system/bin 目 录 下 查看 可 执行 文件 hello。 


5. 重 新 打包 Android 系 统 文件 system.img 


zyhu@ubuntu-50:~/work$ ./summon mkext4img.sh lynx system 


中 


新 打包 后 的 system.img 文 件 会 包含 刚才 编译 好 的 hello 可 执行 文件 。 


6 .测试 


将 新 system (system.img) 烧 写 到 开发 板 ， 启 动机 器 ， 使 用 /system/bin/hello 可 执行 程序 来 访问 Linux 内 核 驱动 程序 。 


root@android:/ # cd system/bin 
root@android:/system/bin # ./hello 
Read the original value: 
Qs 
Write value 5 to /dev/hello. 
Read the value again: 
Dis 


查看 运行 结果 ， 说 明 编 写 的 C 可 执行 程序 可 以 访问 Linux 内 核 驱动 程序 。 


5.1.3 ”接口 硬件 驱动 程序 


Android 的 应 用 程序 是 用 Java 语 言 编写 的 ， 能 不 能 在 Android 的 Application Frameworks 提 供 Java 接 口 来 访问 Linux 内 核 驱动 程序 呢 ? 这 一 节 将 介绍 如 何在 硬件 抽象 层 中 增加 硬件 模块 来 四 内 核 驱动 程序 
交互 ， 以 及 在 Android 系 统 创建 设备 文件 时 用 类 似 Linux 的 udev 规 则 修改 设备 文件 模式 的 方法 。 


1. 新 建 hello 目 录 


内 核 驱动 程序 在 Android 系 统 中 得 到 三 个 文件 ， 分 别 是 /dewhello、/sys/class/hello/hello/val 和 /proc/hello。 将 通过 设备 文件 /dewhello 来 连接 硬件 抽象 层 模 块 和 Linux 内 核 驱 动 程序 模块 。 


2. 新 建 hello.h 文 件 


进入 在 hardware/libhardware/include/hardware 目 录 ， 新 建 hello.h 文 件 : 


zyhu@ubuntu-50:~/work$ cd hardware/libhardware/include/hardware/ 
zyhu@ubuntu-50:~/work/hardware/libhardware/include/hardware$ vim hello.h 
hello.h 
#ifndef ANDROID HELLO INTERFACE H 
#define ANDROID HELLO INTERFACE H 
dinclude «hardware/hardware.h» ` 

BEGIN DECLS 
7* SAE ID* / 
#define HELLO HARDWARE MODULE ID "hello" 
/* 硬 件 模块 结构 体 */ 

struct hello_module_t { 

struct hw module t common; 


1; 
/* 硬 件 接口 结构 体 */ 
struct hello device t { 
struct hw device t common; 
int fd; 
int (*set val) (struct hello device t* dev, int val); 
int (*get val) (struct hello device t* dev, int* val); 
1; 
END DECLS 
Тепаіғ 


按照 Android 硬 件 抽象 层 规范 的 要 求 ， 分 别 定义 模块 ID、 模 块 结构 体 以 及 硬件 接口 结构 体 。 在 硬件 接口 结构 体 中 fd 表示 设备 文件 描述 符 ， 对 应 将 要 处 理 的 设备 文件 /dewWhello"，set_val 和 get_ маі 
HAL 提 供 的 函数 接口 。 


3. 添 加 hello.c 文 件 


进入 hardware/libhardware/modules 目 录 ， 新 建 hello 目 录 ， 并 添加 hello.c 文 件 。 


zyhu@ubuntu-50:~/work/hardware/libhardware/modules$ mkdir hello 
zyhu@ubuntu-50: ~/work/hardware/libhardware/modules/hello$ vim hello.c 
hello.c 
/* 首 先是 包含 相关 头 文件 和 定义 相关 结构 */ 
#define LOG TAG "HelloStub" 
#include «hardware/hardware.h» 
#include <hardware/hello.h> 
#include <fcntl.h> 
#include <errno.h> 
#include <cutils/log.h> 
#include <cutils/atomic.h> 
#define DEVICE NAME "/dev/hello" 
#define MODULE NAME "Hello" 
#define MODULE AUTHOR "shyluo@gmail.com" 
/* 设 备 打开 和 关闭 接口 */ 
static int hello device open (const struct hw module t* module, const char* name, struct hw device t** device); 
static int hello device close(struct hw device t* device); = » 
/* 设 备 访问 接口 */ 
static int hello set val(struct hello device t* dev, int val); static int hello get val(struct hello device t* dev, int* val); 
/* 模 块 方法 表 */ 
static struct hw module methods t hello module methods = { 
open: hello device open Е 
1; 
/* 模 块 实例 变量 */ 
struct hello module t HAL MODULE INFO SYM = ( 
common: { 一 i - Е 
tag: HARDWARE MODULE TAG, 
version major: 1, ` 
version minor: 0, 
id: HELLO HARDWARE MODULE ID, 
name: MODULE МАМЕ, Е 
author: MODULE AUTHOR, 
methods: &hello module methods, 
Í 
1: 
/* 实 例 变量 名 必须 为 HAL MODULE INFO_SYM，tag 也 必须 为 HARDNRARE MODULE TARG， 这 是 Android 硬 件 抽象 层 规范 规定 */ 
/* Ж hello device openiZt*/ 7 m Е 
static int hello_device_open (const struct hw module t* module, const char* name, struct hw device t** device) { 
struct hello device t* dev;dev = (struct hello device t*)malloc(sizeof (struct hello device t)); 
if(!dev) ( 
LOGE("Hello Stub: failed to alloc space"); 
return -EFAULT; 
} 
memset (dev, 0, sizeof (struct hello device t)); 
dev-»common.tag = HARDWARE DEVICE TAG; 
dev-»common.version = 0; “` = 
dev-»common.module = (hw module t*)module; 
dev-»common.close = hello device close; 
dev-»set val = hello set val; dev-»get val = hello get val; 
if ((dev->fd = open(DEVICE NAME, О RDWR)) == -1) í 
LOGE ("Hello Stub: failed to open /dev/hello -- $s.", strerror (errno) ) ; free (dev); 
return -EFAULT; 


} 

*device = &(dev->common) ; 

LOGI ("Hello Stub: open /dev/hello successfully."); 
return 0; 


} 
/* 定 义 hello device close. hello set val 和 hello_ get _ val 函数 */ 
static int hello device close(struct hw device t* device) { 
struct hello device t* hello device = (struct hello device t*)device; 
if(hello device) ( 
close (hello device->fd) ; 
free (hello device); 
} 
return 0; 
$ 
static int hello set val(struct hello device t* dev, int val) { 
LOGI("Hello Stub: set value $d to device.", val); 
write (dev->fd, &val, sizeof(val)); 
return 0; 
} 
static int hello_get_val(struct hello_device_t* dev, int* val) { 
if(!val) ( 
LOGE("Hello Stub: error val pointer"); 
return -EFAULT; 
} 


read(dev->fd, val, sizeof (*val)); 


LOGI ("Hello Stub: get value %d from device", *val); 
return 0; 


4. 在 hello 目 录 下 新 建 Android.mk 文 件 


Android.mk 

LOCAL_PATH := $(call my-dir) 

include $(CLEAR VARS) 

LOCAL MODULE TAGS 
LOCAL PRELINK MODULE false 

LOCAL MODULE PATH :- $(TARGET OUT SHARED LIBRARIES) /hw 
LOCAL SHARED LIBRARIES := liblog ` Е 

LOCAL SRC FILES := hello.c LOCAL MODULE := hello.default 

include S$(BUILD SHARED LIBRARY) ~ 


optional 


根据 LOCAL MODULE 的 定义 规则 可 知 : hello 后 面 跟 有 default，hello.default 能 够 保证 模块 总 能 被 硬件 抽象 层 加 载 。 


5. 编 译 


zyhu@ubuntu-50:~/work/hardware/libhardware/modules/hello$ mm 


编译 成 功 后 ， 在 out/target/product/lynx/system/lib/hw/ 目 录 下 能 查看 到 hello.default.so 文 件 。 


6. 重 新 打包 Android 系 统 镜像 system.img 


zyhu@ubuntu-50:~/work$ ./summon mkext4img.sh lynx system 


新 打包 后 ，system.img 就 包含 定义 的 硬件 抽象 层 模 块 hello.default。 


5.1.4 ”J 改 | 醒 件 驱 动 程序 


hi 


虽然 在 Android 系 统 中 为 硬件 增加 了 一 个 硬件 抽象 层 模块 ， 但 是 Java 应 用 程序 还 不 能 访问 硬件 ， 还 必须 编写 JN1 方 法 并 在 Android 的 Application Frameworks 层 增加 API 接 口 ， 才 能 让 上 层 Application 访 
问 硬件 。Java 提 供 了 JINI 调 用 方法 ， 使 用 Android 硬 件 抽象 层 接口 编写 JNI 方 法 ， 在 Android 系 统 中 Java 应 用 程序 通过 JNl 来 调用 硬件 抽象 层 接口 ， 使 得 上 层 的 Java 应 用 程序 能 够 使 用 下 层 提 供 的 硬件 服务 。 


1. 新 建 com_android_server_HelloService.cpp 文 件 


进入 frameworks/base/services/jni 目 录 新 建 cCom_android_server_HelloService.cpp 文 件 。 


zyhu@ubuntu-50:~/work/frameworks/base/services/jni$ 
vim com android server HelloService.cpp 


在 com_android_server_HelloService.cpp 文 件 中 实现 JN| 方 法 。com_android_server 前 缀 表示 的 是 包 名 ， 表 示 硬 件 服务 HelloService 是 放 在 frameworks/base/services/java 目 录 下 的 
com/android/server 目 录 ， 即 存在 一 个 命名 为 com.android.server.HelloService 的 类 。HelloService 是 一 个 提供 Java 接 口 的 硬件 访问 服务 类 。 


com android server HelloService.cpp 
/* 首先 应 包含 相应 的 头 文件 */ 
#define LOG TAG "HelloService" 
#include "jni.h" 
#include "JNIHelp.h" 
#include "android runtime/AndroidRuntime.h" 
#include <utils/misc.h> 
#include <utils/Log.h> 
#include <hardware/hardware.h> 
#include <hardware/hello.h> 
#include <stdio.h> 
/* 接着 定义 hello init. hello getValfehello setVal 这 三 个 JNI 方 法 */ 
namespace android  ( ur > 
/* 在 硬件 抽象 层 中 定义 的 硬件 访问 结构 体 ， 参 考 <hardware/hello.h>*/ 
struct hello device t* hello device = NULL; 
/* 通 过 硬件 抽象 层 定义 的 硬件 访问 接口 设置 硬件 寄存 器 Val 的 值 */ 
static void hello setVal(JNIEnv* env, jobject clazz, jint value) { 
int val = value; 
LOGI ("Hello JNI: set value $d to device.", val); 
if(!hello device) ( 
LOGI("Hello JNI: device is not open."); 
return; 


hello device-»set val(hello device, val); 


l 
/* 通 过 硬件 抽象 层 定义 的 硬件 访问 接口 读 取 硬件 寄存 器 val 的 值 */ 
static jint hello_getVal(JNIEnv* env, jobject clazz) { 
int val = 0; 
if(!hello device) ( 
LOGI("Hello JNI: device is not open."); 
return val; 


hello device-»get val (hello device, &val); 
LOGI("Hello JNI: get value $d from device.", val); 
return val; 


} 
/* 通 过 硬件 抽象 层 定义 的 硬件 模块 打开 接口 打开 硬件 设备 */ 
int hello device open(const hw module t* module, struct hello device t** device) { 
return module-»methods-»open (module, HELLO HARDWARE MODULE ID, (struct hw device t**)device); 


) 

/* 通 过 硬件 模块 TD 来 加 载 指定 的 硬件 抽象 层 模 块 并 打开 硬件 */ 
static bool hello init(JNIEnv* env, jclass clazz) { 
hello module t* module; 


LOGI ("Hello JNI: initializinghttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/ . .http: / /www.hzcourse.com/resource/readE 


if(hw get module(HELLO HARDWARE MODULE ID, (const struct hw module t**)&module) == 0) { 
LOGI("Hello JNI: hello Stub found."); 
if(hello device open(&(module-»common), &hello device) == 0) ( 
LOGI("Hello JNI: hello device is open."); 
return 0; 


) 
LOGE("Hello JNI: failed to open hello device."); 
return -1; 


l 
LOGE("Hello JNI: failed to get hello stub module."); 
return -1; 


) 
/*JNI 方 法 表 */ 


static const JNINativeMethod method table[] = ( 
("init native", "()Z", (void*)hello init), 
("setVal native", "(I)V", (void*)hello setVal}, 
("getVal native", "()I", (void*)hello getVal) 


}; 
/* 注 册 JNI 方 法 */ 


int register android server HelloService(JNIEnv *env) { 
return jniRegisterNativeMethods (env, "com/android/server/HelloService", method _ 
table, NELEM(method table)); 
} 
H 


在 hello_init 函 数 中 通过 Android 硬 件 抽象 层 提供 的 hw_get_module 方 法 来 加 载 模块 1D 为 HELLO_HARDWARE_MODULE 1D 的 硬件 抽象 层 模块 ， 其 中 HELLO_HARDWARE_MODULE ID 是 在 
<hardware/hello.h> 中 定义 的 。Android 硬 件 抽象 层 根据 HELLO_HARDWARE_MODULE ID 的 值 在 Android 系 统 的 /systemylib/hw 目 录 中 找到 相应 的 模块 进行 加 载 ， 并 且 返 回 hw_module t 接 口 给 调用 者 
使 用 。 在 jniRegisterNativeMethods 函 数 中 的 第 二 个 参数 的 值 必须 对 应 HelloService 所 在 的 包 的 路 径 ， 即 com.android.server.Helloservice。 


2. 修 改 同 目录 下 的 onload.cpp 文 件 


首先 在 namespace android 中 增加 register_ android_server_Helloservice 函 数 声明 : 


namespace android { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
int register android server HelloService(JNIEnv *env) ; 


H 


在 JNI_onLoad 中 增加 register android server_Helloservice 函 数 调用 : 


extern "C" jint JNI_onLoad(JavaVM* vm, void* reserved) { 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
register_android_server_HelloService (env) ; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
} 


在 Android 系 统 初始 化 时 ， 自 动 加 载 该 JNI 方 法 调用 表 。 


3. 修 改 同 目 录 下 的 Android.mk 文 件 


在 LOCAL_SRC_FILES 变 量 中 增加 如 下 代码 : 


LOCAL_SRC_FILES:= \ 

com_android_server AlarmManagerService.cpp \ 
com android server BatteryService.cpp Ñ 

com android server KeyInputQueue.cpp \ 

com android server LightsService.cpp \ 

com android server SensorService.cpp \ 

com android server SystemServer.cpp \ 

com android server VibratorService.cpp Ñ 
com_android server HelloService.cpp N 
onload.cpp 


4 编译 和 重新 打包 system.img 


zyhu@ubuntu-50:~/work/frameworks/base/services/jni$ mm zyhu@ubuntu-50:~/work$ ./summon mkext4img.sh lynx system 


重新 打包 的 system.img 镜 像 文件 包含 刚才 编写 的 JNI 方 法 ， 通 过 Android 系 统 的 Application Frameworks 层 提供 的 硬件 服务 HelloService 来 调用 这 些 JNI 方 法 ， 进 而 实现 调用 低层 的 硬件 抽象 层 接口 去 访 
问 硬件 。 


5.2 ”GPIO 接 口 及 驱动 程序 


52.1 ”GPIO 接 口 


1.GPIO 简 介 


S5PV210 包 括 237 个 多 功能 输入 /输出 端口 引 脚 和 142 个 内 存 端口 引 脚 ， 如 图 5-2 所 示 ， 共 有 34 个 一 般 端口 组 和 2 个 内 存 端口 组 。 
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图 5-2 输入 输出 框图 


每 一 个 引 脚 都 可 以 由 软件 配置 来 满足 各 种 系统 配置 和 设计 需求 。 在 启动 程序 之 前 必须 定义 每 个 引 脚 的 功能 。 如 果 引 脚 没有 配置 为 多 用 途 功 能 ,这 个 引 脚 将 被 配置 为 |/O 接 口 。 


2.S5PV210 输 入 /输出 类 型 


S5PV210 输 入 /输出 类 型 ( 见 表 5-1) 。 


表 5-1 输入 /输出 类 型 


ПО 类 型 IO 组 i Ж 
A GPA0、GPA1、GPC0、GPC1、GPD0、GPD1、GPE0、GPE1、GPF0 | 普通 IO 
B GPFl, GPF2, СРЕЗ, ОРНО, GPHI, GPH2, GPH3, GPI, GPJO (3.3V I/O) 
C MP1, MP2 DRAM I/O ( 1.8V IO) 


3.GPIO 专 用 寄存 器 


(1) 端口 组 控制 寄存 器 


Т) 控制 寄存 器 。 在 S5PV210 系 统 中 ， 大 多 数 引 脚 是 多 用 途 的 。 每 一 个 引 脚 要 求 定义 一 个 功能 ， 控 制 寄 存 器 定义 每 一 个 引 脚 的 功能 。 


2) 数据 寄存 器 。 如 果 引 脚 配置 为 输出 ， 数 据 可 以 被 写 到 引 脚 在 数据 寄存 器 对 应 的 位 中 。 如 果 引 脚 配置 为 输入 ， 可 以 从 数据 寄存 器 对 应 的 位 中 读 出 数据 。 
3) 上 拉 寄 存 器 。 使 能 引 脚 输出 或 输入 上 拉 为 高 电 平 或 下 接 为 低 电 平 ， 上 拉 寄 存 器 定义 每 一 个 引 脚 上 拉 / 下 拉 使 能 或 禁止。 


S5PV210 包 括 GA0、GA1、GPB、GPC0、GPC1、GPD0、GPD1、GPE0、GPE1、GPF0、GPF1、GPF2、GPF3、GPG0、GPG1、GPG2、GPG3、GPJO、GPJ1、GPJ2、GPJ3、GPJ4、MP0 1、 
MPO 2, MPO 3, MPO 4, MPO 5, MPO 6. MPO 7. МРТ 0, МР1 1, MP1 2, МР1 3, MP1 4, МРТ 5, MP1 6. MP1 7. МРТ 8, MP2 0. MP2 1, МР2 2, MP2 3. MP2 4. МР2 5. 
MP2_6、MP2_7、MP2_8 等 47 组 端口 ， 每 个 端口 有 6 个 控制 寄存 器 。 


(2) 端口 组 GPA0 控 制 寄存 器 


端口 组 GPA0 中 有 6 个 控制 寄存 器 : GPAOCON、GPA0ODAT、GPAOPUD、GPA0ODRV、GPAOCONPDN 和 GPAOPUDPDN， 如 表 5-2~ 表 5-7 所 示 。 
- GPA0 控 制 寄存 器 (GPA0CON， 读 / 写 ， 地 址 =0xE020_0000) 


表 5-2 GPA0CON 控 制 寄存 器 


GPAOCON mam 


0000 = 输入 0001 = 输出 
0010 = UART 1 RTSn 

GPAOCON[7] [31:28] BOT itii- RR 0000 
1111 = GPAO INT[7] 
0000 = #7 A 0001 = 输出 
0010 = UART_1_CTSn 

GPAOCON[6] [27:24] морит" 0000 
1111 = GPAO INT[6] 
0000 = Л 0001 = 输出 
0010 = UART 1 TXD 

GPAOCON[5] [23:20] BOT m= PEE 0000 
1111 = GPAO_INT[5] 
0000 = #7 À 0001 = 输出 
0010 = UART 1 RXD 

GPAOCON[4] [19:16] 0011 ~ 1110/8] 0000 
1111 = GPAO INT[4] 
0000 = #7 À 0001 = 输出 
0010 = UART 0 RTSn 

GPAOCON[3] [15:12] GOTT >й» бш 0000 
1111 = GPAO INT[3] 
0000 = À 0001 = 输出 
0010 = UART 0 CTSn 

GPAOCON[2] [11:8] 0011 ~ 1110 二 保留 0000 
1111 = GPAO INT[2] 
0000= 1 Л 0001 = 输出 
0010 = UART_0 TXD 

GPAOCON[1] [7:4] 0011 = 110- Bid 0000 
1111 = GPAO INT[1] 


0000 = 输入 0001 = 输出 
0010 = UART 0 RXD 


GPAOCON[0 3:0 0000 
[0] [aw] 0011 ~ 1110 = 保留 
1111 = GPAO INT[0] 
- GPA0 数 据 寄存 器 (GPA0DAT， 读 / 写 ， 地 址 =0xE020_0004) 
表 5-3 GPAODAT 数 据 寄存 器 
GPAODAT 初始 值 


当 端 口 被 配置 为 输入 端口 ， 相 应 位 为 引 脚 的 状态 ; ` 
GPAODAT[7: 0] 端口 配置 为 输出 端口 ， 引 脚 的 状态 是 一 样 的 相应 位 ; 当 0x00 
端口 被 配置 为 功能 引 脚 ， 将 读 取 未 定义 的 值 


- GPA0 上 拉 寄 存 器 (GPA0PUD， 读 / 写 ， 地 址 =0xE020_0008) 


表 5-4 GPA0PUD 上 拉 寄 存 器 


GPAOPUD 初始 值 


00= 禁 目 上 拉 / 下 拉 


[2n+1:2n] 01= 可 以 下 拉 
n=0~7 10= 可 以 上 拉 
11 = 保留 


GPAOPUD[n] 0x5555 


- GPA0 驱 动 强度 寄存 器 (GPAODRV， 读 / 写 ， 地 址 =0xE020_000C) 


表 5-5 GPAODRV 驱 动 强度 寄存 器 


GPAODRV 初始 值 
[2n+1:2n] 
GPAODRV[n] 0x000 
n=0~7 
- GPA0 电 源 中 断 模式 寄存 器 (GPA0CONPDN， 读 / 写 ， 地 址 =0xE020_0010) 
表 5-6 GPA0CONPDN 寄 存 器 
GPAOCONPDN 初始 值 
00= 输 出 0 
[2n+1:2n] 01= 输 出 1 
GPAO 0x00 
ЖАП n=0~7 10= 输 入 
11 = 前 一 状态 
- GPA0 电 源 中 断 模式 上 拉 寄 存 器 (GPAOPUDPDN， 读 / 写 ， 地 址 =0xE020_0014) 
Ж5-7 GPAO0PUDPDN Ў Ф Ж 
GPAOPUDPDN 初始 值 
00= 禁 止 上 拉 / 下 拉 
[2n+1:2n] 01= 可 以 下 拉 
GPAO[n , 0х00 
[n] n-0-7 10= 可 以 上 拉 
11 = 保留 
(3) 端口 组 GPA1 控 制 寄存 器 
端口 组 GPA1 控 制 寄存 器 中 有 6 个 控制 寄存 器 : GPA1CON、GPA1DAT、GPA1PUD、GPA1DRV、GPA1CONPDN 和 GPA1PUDPDN， 如 表 5-8~ 表 5-13 所 示 。 
- GPA1 控 制 寄存 器 (GPA1CON， 读 / 写 ， 地 址 =0xE020_0020) 
表 5-8 GPA1CON 寄 存 器 
GPA1CON 初始 值 


0000 = #7 А 0001 = 输出 

0010 = UART 3 TXD 
GPAICON[3] : 0011 = UART 2 RTSn 0000 

0100 ~ 1110 = 保留 

1111 =GPA1_INT[3] 

0000 = fA 0001 = 输出 

0010 = UART 3 RXD 
GPAICON[2] : 0011 =UART 2 CTSn 0000 

0100 ~ 1110 = 保留 

1111 = GPA1 INT[2] 

0000 = 9 À 0001 = 输出 

0010 = UART 2 TXD 

0011 = Reserved 

0100 = UART AUDIO TXD 

0101 ~ 1110 = 保留 

1111 = GPA1_INT[1] 

0000 = 输入 0001 = 输出 

0010 = ОАВТ 2 RXD 

0011 = 保留 

0100=UART AUDIO RXD 

0101 ~ 1110 = 保留 

1111 = GPA1_INT[0] 


GPAICON[1] 0000 


GPAICON[0] 0000 


- GPA1 数 据 寄存 器 (GPA1DAT， 读 / 写 ， 地 址 =0xE020_0024) 


表 5-9 GPAIDATZ 4S 


GPA1DAT 初始 什 
当 端 口 被 配置 为 输入 端口 ， 相 应 位 为 引 脚 的 状态 ; 24 
GPAIDAT[3: 0] : 端口 配置 为 输出 端口 ， 引 脚 的 状态 是 一 样 的 相应 位 ; ` 0x00 
端口 被 配置 为 功能 引 脚 ， 将 读 取 未 定义 的 值 
- GPA1 上 拉 寄 存 器 (GPA1PUD, 读 / 写 ， 地 址 =0xE020_0028) 
表 5-10 GPA1PUD 寄 存 器 
GPA1PUD 初始 值 
00= 禁 止 上 拉 / 下 拉 
GpALEUDTaI [2n+1:2n] 01= 可 以 下 拉 — 
n X 
n-0-3 10= 可 以 上 拉 
11 = 保留 
+ GPA1 了 驱动 强度 寄存 器 (GPA1DRV， 读 / 写 ， 地 址 =0xE020_002C) 
表 5-11 GPA1DRV 寄 存 器 
GPA1DRV 初始 值 
[2n+1:2n] 
GPAIDRV[n] 0x000 
n=0~3 
+ GPA1 电 源 中 断 模式 寄存 器 (GPAICONPDN, 4/5, A353E-0xE020. 0030) 
表 5-12 GPA1CONPDN 寄 存 器 
GPA1CONPDN y 初始 值 
00 = 输出 0 
| [2n+1:2n] 01= 输 出 1 
GPAI[n 0x00 
[n] n-0-3 10= 输 入 
11 = 前 一 状态 


- GPA1 电源 中 断 模 式 上 拉 寄 存 器 (GPA1PUDPDN， 读 / 写 ， 地 址 =0xE020_0034) 


表 5-13 GPA1PUDPDN 寄 存 器 


GPA1PUDPDN 
00= 禁 止 上 拉 / 下 拉 
[2n+1:2n] 01= 可 以 下 拉 
СРАІ 0х00 
Fen) n-0-3 10 = 可 以 上 拉 


11 = RE 


(4) GPIO 中 断 控制 寄存 器 
GPIO 中 断 包括 22 组 ， 即 GPA0、GPA1、GPB、GPC0、GPC1、GPD0，GPD1、GPE0、GPE1、GPF0、GPF1、GPF2、GPF3、GPG0、GPG1、GPG2、GPG3、GPJO、GPJ1、GPJ2、GPJ3 和 


GPJ4。 


数字 滤波 器 ， 以 检测 中 断 。 如 果 过 滤器 被 禁用 ， 那 么 在 很 大 的 概率 上 ， 系 统 可 以 检测 到 


要 的 是 理解 滤波 运算 。 
外 部 中 断 。 表 5-14~ 表 5-16 显 示 了 GPIO 的 中 断 


在 中 断 功能 中 ， 习 
两 种 类 型 的 过 滤器 来 检测 中 断 : 延迟 滤波 器 和 数字 滤波 器 。 当 使 
测 ) 。 为 了 检测 所 有 中 断 稳定 ， 最 好 设置 过 滤 启 


中 断 功能 ， 设 置 或 者 延迟 或 启 
。 不 能 使 用 GPIO 中 断 唤醒 源 。 如 果 要 唤醒 中 断 源 ， 可 以 使 


S5PV210 使 
几乎 所 有 的 中 断 连续 中 断 (将 错过 一 些 中 断 检 


控制 寄存 器 。 
表 5-14 ”中 断 配 置 寄存 器 


a 存 8 复位 什 
ОРАО INT CON JE GPIO ЇЙЇ ОРАО INT ft 0x0 
GPA1_INT_CON 读 / 写 GPIO 中 断 GPA1 INT 配置 0x0 

(AE) 

т f 器 地 HE z/ = ж Ж 复位 值 
GPB_INT_CON 0xE020_0708 读 / 写 GPIO {ЙТ GPB_INT 配置 0x0 
GPCO_INT_CON OxE020 070C 读 / 写 GPIO 中 断 GPCO INT 配置 0x0 
GPC1_INT_ CON 0хЕ020 0710 读 / 写 GPIO 中 断 GPC1_INT 配置 0x0 
GPDO INT CON 0xE020 0714 读 / 写 GPIO 中 断 GPDO INT 配置 0х0 
GPDI INT CON 0хЕ020 0718 BS GPIO ФТ GPD1 INT 配置 0х0 
GPEO INT CON GPIO 中 断 СРЕО INT 配置 0x0 
СРЕІ INT CON 0хЕ020 0720 iE / g GPIO 中 断 GPE1 INT 配置 0х0 
GPFO INT CON 0хЕ020 0724 读 / 写 GPIO 中 断 GPFO_INT 配置 0x0 
GPF1 INT CON 0хЕ020 0728 i / 5 GPIO 中 断 GPF1_INT 配置 0x0 
GPF2_INT_CON GPIO 中 断 GPF2 INT 配置 0x0 
GPF3_INT_CON GPIO 中 断 СРЕЗ ІМТ 配置 0х0 
GPGO_INT_CON GPIO 中 断 GPGO INT 配置 0х0 
GPGI INT CON 0хЕ020 0738 GPIO 中 断 GPG1. INT 配置 0x0 
GPG2 INT CON OxE020 073C GPIO 中 断 GPG2_INT 配置 0x0 
GPG3_INT_CON 0xE020 0740 GPIO 中 断 GPG3 INT 配置 0x0 
GPJO INT_CON GPIO 中 断 GPJO INT 配置 0x0 
GPJ1_INT_CON GPIO 中 断 GPJ1_INT 配置 0х0 
GPJ2_INT_CON OxE020 074C 读 / 写 GPIO 中 断 GPJ2 INT 配置 0x0 
GPJ3 INT CON 0хЕ020 0750 读 / 写 GPIO 中 断 GPJ3_INT 配置 0х0 
GPJ4_INT_CON 0хЕ020 0754 读 / 写 GPIO 中 断 GPJ4_INT 配置 0x0 

表 5-15 PARTAR 

EE Rx KE 
GPB_INT_MASK GPIO 中 断 GPB_INT 屏蔽 0x000000FF 
GPC1_INT_MASK GPIO 中 断 GPC1_INT 屏蔽 0x0000001F 
GPD0 INT MASK GPIO 中 断 GPD0 INT 屏蔽 0x0000000F 
GPF3 INT MASK GPIO 中 断 GPF3 INT 屏蔽 0x0000003F 


EE EE 
GPG0 INT MASK GPIO 中 断 GPG0_INT БЕ 0x0000007F 
GPJI INT. MASK GPIO 中 断 GPJ1_INT 屏蔽 0x0000003F 
GPJ3 INT MASK 读 / 写 GPIO 中 断 GPJ3 INT 屏蔽 Ox000000FF 


A516 中断 挂 起 寄存 器 


CE 


cet Z 
= E 
GPF3 INT PEND GPIO 中 断 СРЕЗ INT 挂 起 m 
Eus E 
ToS E 


5.2.2 ”LED 接口 电路 


2: 
dm) 


1.LED 驱 动 电 路 


LED (Light Emitting Diode) 即 发 光 二 极 管 ， 是 嵌入 式 系 统 中 常用 的 输出 设备 。 单 个 LED 通 常用 作 警 示 ， 如 故障 指示 或 提示 信号 等 。LED 是 一 种 半导体 发 光 设备 ， 当 电流 流 过 它 的 时 人 息 ， 可 以 产生 可 见 
光 。LED 的 发 光 强 度 与 通过 的 电流 强度 成 正比 。LED 发 光 的 颜色 可 以 是 红 、 黄 、 绿 或 蓝 色 。 


DMA-210XP 实 验 平 台 LED 驱 动 电路 原理 如 图 5-3 所 示 。 


Q4 
AA 02 MMBT3904 


Q5 
AA D5 MMBT3904 


图 5-3 LED 驱 动 电 路 原理 


由 图 5-3 可 知 ， 对 LED 状 态 的 控制 完全 由 对 应 MO 口 的 输出 状态 决定 。 因 为 LED 的 一 端 接 高 电 平 ， 另 一 端 接 一 个 NPN 型 的 晶体 管 ， 所 以 要 想 点 亮 LED， 就 必须 导 通 对 应 的 晶体 管 。 在 这 里 晶体 管 作为 一 个 
开关 ， 当 对 应 的 GPIO (GPJ3_0~GPJ3_1) 为 高 电 平时 ， 晶 体 管 的 B 端 就 为 高 ， 从 而 使 对 应 的 晶体 管 导 通 ， 相 应 的 LED 也 就 被 点 亮 。 当 对 应 的 GPIO 为 低 电 平时 ， 晶 体 管 的 B 端 就 为 低 ， 晶 体 管 关闭 ， 相 应 的 


LED 也 就 被 熄灭 。 所 以 只 要 控制 相关 的 MO 口 即 可 完成 对 LED 的 控制 。 图 5-3 中 的 电阻 起 分 压 的 作用 ， 从 而 使 得 LED 不 会 太 亮 。 但 电阻 也 不 能 太 大 ， 否 则 将 会 影响 LED 的 实际 效果 。 


2 .端口 组 GPJ3 控 制 寡 存 器 


端口 组 有 6 个 控制 寄存 器 : GPJ3CON、GPJ3DAT、GPJ3PUD、GPJ3DRV、GPJ3CONPDN 和 GPJ3PUDPDN 在 端口 组 GPJ3 控 制 寄 存 器 。LED 接 口 主要 由 GPJ3_0 和 GPJ3_1 两 个 I/O 口 控制 ， 分 别 对 应 着 2 
个 LED 指 示 灯 。 其 中 涉及 的 寄存 器 有 GPJ3CON、GPJ3DAT 和 GPJ3PUD。 


5.2.3 LED 驱动 程序 设计 


在 DMA-210XP 平 台 上 配置 有 2 个 LED 指 示 灯 ， 分 别 由 GPIO 接 口 的 GPJ3_0 和 GPJ3_1 控 制 。 在 Android 系 统 下 实现 对 2 个 LED 指 示 灯 的 控制 ， 编 写 LED 驱 动 程序 并 将 结果 显示 在 LCD 屏 幕 上 。 


1.LED 驱 动 程序 分 析 


(1) LED 驱 动 程序 结 构 


LED 字 符 设备 驱动 程序 实现 的 函数 有 led_open(0、led release(, led геаа(). led write(), led ioctl0， 把 这 些 函 数 分 别 赋值 给 struct file_operations 结 构 中 对 应 的 成 员 变 量 ， 并 注册 struct 
file operations 结 构 。 这 样 ， 当 使 用 者 打开 设备 时 ， 调 用 led_open() 函 数 ; 关闭 设备 时 ， 调 用 led_release; 如 果 要 改变 LED 状 态 时 ， 可 以 直接 向 led_ioctI() 函 数 传递 参数 。 


LED 设 备 驱 动 程序 的 struct file_operations 结 构 声 明 如 下 : 


static struct file operations led fops = 
{ 

owner : THIS MODULE, 

read : led_read, 

write : led write, 

ioctl : led ioctl, 

open : led open, 

release : led release, 


1; 


(2) 设备 驱动 函数 介绍 
` led_open() 


在 LED 驱 动 程序 的 open 函 数 中 完成 初始 化 配置 GPIO 口 GPJ3 0 和 GPJ3_1， 代 码 如 下 : 


static int led_open(struct inode *inode, struct file *filp) 
{ /* 初 始 化 GPIO 引 脚 */ 

unsigned int val; 

val = readl(S5PV210 GPJ3CON); 

val &= ~ (Oxff ««0); 

val |= (1 << 0) | (1<<4); 

writel (val, S5PV210 GPJ3CON) ; 

val = readl(S5PV210 GPJ3DAT); 


val |= ((1 ««0)| (1<<1)); 
writel (val, S5PV210 GPJ3DAT); 
return 0; 
l 

+ led ioctl() 


ioct| 是 驱动 程序 的 窗口 ， 应 用 程序 可 以 通过 ioctl 函 数 向 驱动 程序 发 送 指令 。 以 完成 驱动 程序 对 硬件 的 控制 。led_ioctl() 函 数 程序 代码 如 下 : 


static int led_ioctl(struct inode *inode, struct file *file, unsigned int cmd, unsigned long arg) 
{ 

int ret = 0; 

int num; 

switch (cmd) 


case LED ON: 
ret = copy from user(&num, (int *)arg, sizeof(int)); 
if (ret != 0) 


printk("gpio ioctl: copy from user failed\n"); 
return (-EFAULT); 

} 

printk ("num = %d\n",num) ; 

Іеа оп (пот); 

break; 

case LED OFF: 

ret = copy from user(&num, (int*)arg, sizeof(int)); 
if (ret != 0) 

{ 

printk("gpio_ioctl: copy_from_user failed\n"); 
return (—EFAULT) ; 

} 

printk ("num = %d\n",num) ; 

led off (num) ; 

break; 

case LED TEST: 

led test () ;break; 

} 

return 0; 


} 


+ led_tead() Feled_write() 


这 两 个 函数 在 驱动 程序 中 没有 做 实质 性 的 处 理工 作 ， 只 是 把 成 功 读 取 的 count 参 数 返 回 给 系统 。 代 码 如 下 : 


static ssize t led read(struct file *filp,char *buf,size t,count,loff t *1) { 

return count; 

} 

static ssize t led write(struct file *filp,const char *buf,size t,count,loff t *f_ops) { 
return count; 


led init (void) 


* led init (void) 


led_init() 为 驱动 程序 的 入 口 函 数 ， 既 是 入 口 函数 又 是 模块 初始 化 函数 ， 完 成 对 LED 的 初始 化 功能 ， 包 括 对 LED 地 址 的 申请 和 缓存 器 的 设置 功能 ， 并 完成 对 LED 驱 动 的 注册 。 代 码 如 下 : 


static int init led init (void) 

1 

int retval; 

retval = register chrdev (LED MAJOR, led name, &led fops); 
if(retval « 0) 


{ 

printk(KERN WARNING "Can't get major %d\n",LED MAJOR); 
return retval; 

} 

printk("LED driver register success!\n"); 

return 0; 


} 


+ led_on() Feled_off() 
在 ioctl 函 数 中 ， 控 制 LED 的 状态 函数 ， 通 过 led_on() 来 点 亮 LED 灯 ， 再 通过 led_off() 来 熄灭 LED， 代 码 如 下 : 


led onQ: 使 相应 的 GPIO 输 出 为 高 电位 。 


static void led_on(int led_num) 

{ 

int gpj3dat; 

gpj3dat = raw readl(S5PV210 GPJ3DAT); 
switch (led num) 


{ 

case 1:// ledl 
gpj3dat |= (1<<0); 
break; 

case 2: 

gpj3dat |= (1««1); 
break; 

default: 

break; 

} 

__raw_writel (gpj3dat,S5PV210_GPJ3DAT); 
H 


led off(: 使 相应 的 GPIO 输 出 为 低 电 位 。 


static void led_off(int led num) 

{ 

int gpj3dat; 

gpj3dat = гам readl(S5PV210 СРЈЗРАТ); 
switch (led num) 


{ 

case 1:// ledl 
gpj3dat &--(1««0); 
break; 

case 2: 

gpj3dat &--(1««1); 
break; 

default: 

break; 

} 

. raw writel(gpj3dat,S5PV210 GPJ3DAT); 
] 


上 面 介 绍 的 函数 是 LED 驱 动 程序 的 主要 组 成 部 分 。 通 过 以 上 分 析 ， 读 者 可 以 了 解 如 何 控制 GPIO 的 输出 状态 让 LED 点 亮 或 熄灭 。 其 中 关于 GPIO 的 输出 状态 是 由 应 用 程序 控制 的 。 


(3) LED 驱 动 程序 Makefile 文 件 


对 驱动 程序 都 采用 Makefile 文 件 进行 交叉 编译 。 下 面 是 Makefile 文 件 测试 程序 。 


CC -/usr/local/arm/arm-2009q3/bin/arm-none-linux-gnueabi-gcc 
210X KERNEL DIR =/home/ach/dma210xp_book/ch4/android_kernel_2.6.35_dma210xp 
ifneq ($(KERNELRELEASE) , ) 


obj-m := led.o 


else 

KERNELDIR = $ (210X KERNEL DIR) 

PWD := $(shell pwd) 

default: 

5 (МАКЕ) -C $(KERNELDIR) M=$ (PWD) modules 


rm -f *.ko *.o 


关于 Makefile 文 件 的 结构 在 这 里 不 再 做 详细 说 明 (细节 请 参考 Makefile 相 关 材料 ) 。 这 里 为 了 方便 读者 理解 ， 只 是 提供 了 一 个 编译 驱动 程序 的 Makefile， 读 者 也 可 以 自己 试 着 制作 一 个 Makefile 脚 本 来 
编译 驱动 程序 。 本 书 在 编译 驱动 程序 时 要 对 Makefile 做 如 下 修改 : 


“ 修改 内 核 所 在 路 径 ， 代 码 如 下 : 


210X KERNEL DIR-/home/ach/dma210xp book/ch4/android kernel | 


“ 指定 交 又 编译 器 及 其 路 径 ， 代码 如 下 : 


CC =/usr/1ocal/arm/arm-2009q3/bin/arm-none-1linux-gnueabi-gcc 


(4) LED 驱 动 测试 


前 面 对 LED 硬 件 及 其 驱动 程序 代码 进行 了 分 析 ， 下 面 介绍 驱动 程序 的 设计 。 这 里 使 用 的 内 核 版 本 为 Linux 2.6.35。 


驱动 程序 的 编译 其 实 很 简单 ， 直 接 使 用 “make” 指 令 即 可 ， 如 图 5-4 所 示 。 


驱动 编译 成 功 之 后 ， 会 得 到 一 个 led.ko 文 件 ， 即 LED 的 驱动 程序 。 由 于 采用 的 是 动态 编译 的 方式 ， 所 以 需要 在 Android 系 统 中 使 用 “insmod ”指令 加 载 LED 驱 动 ， 相 关 指 令 为 “insmod led.ko" , 


2.LED 界 面 设计 


在 前 一 小 节 设 计 出 了 驱动 程序 ， 这 一 节 主 要 介绍 如 何 设计 应 用 界面 以 进行 LED 亮 暗 控制 。 具 体 步骤 如 下 。 


(1) 在 Eclipse 中 新 建 一 个 工程 


1) 右 击 Package Explorer 的 空白 处 ， 弹 出 如 图 5-5 所 示 菜 单 。 


ach@ubuntu:~/dma216xp book/ch8/Driver Source/led$ make 
make -C /home/ach/dma210xp book/ch4/android kernel 2.6.35 dma218xp M=/home/ac 
h/dma218xp book/ch8/Driver Source/led modules 
make[1]: Entering directory  /home/ach/dma210xp book/ch4/endroid kernel 2.6.3 
5 дта210хр' 

CC [M] /home/ach/dma218xp book/ch8/Driver Source/led/led.o 

Building modules, stage 2. 


MODPOST 1 modules 

сс /home/ach/dma210xp book/ch8/Driver Source/led/led.mod.o 

LD [M] /home/ach/dma210xp book/ch8/Driver Source/led/led.ko 
make[1]: Leaving directory  /home/ach/dma218xp book/ch4/ardroid kernel 2.6.35 
dma218xp' 
achgubuntu:-/dma218xp book/ch8/Driver Source/led$ 


图 5-4 LED 了 驱动 编译 
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5-5 Zi Package Explorer £j Ф 


2) 在 弹出 菜单 中 选择 “New” 一 “Project”， 如 图 5-6 所 示 。 弹 出 如 图 5-7 所 示 窗 口 。 


3) 选择 “Android” 一 “Android Project”， 点 击 “Next” 按 钮 。 弹 出 如 图 5-8 所 示 窗 口 ， 在 相应 位 置 填 入 信息 。 


dog Project... 
Show In ALttShi ЕЕН P F Example.. 


Copy Ctrl+C F5 Other. .. 


国 Copy Qualified Name 
Paste Ctrl+V 
M Delete Delete 


45-6 ”新 建 工程 项 目 


Ў Interface 

z s Java Project 

i * Java Project from Existing Ant Buildfile 
5-08 Plug-in Project 

由 L General 


B-E Android 
| as Android Project 
д] Android Test Project 
可 Android XML File 
"E: 
t= Java 
+) > Plug-in Development 
&j (= User Assistance 


H5 新 建 工程 项 目 窗口 


New Android Project 


Creates a new Android Project resource. 


Project name: Led Control 


Contents 


@ Create new Project in workspace 


© Create Project from existing source 


Use default location 


O Create project from existing sample 


Samples: 


Apilemos 


Build Target 


Target 


Name 


C] Android 1.5 


Google APIs 
Android 1.6 


Vendor 


Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open S 


Source 


Source 


Pra 


= = = LÍ 


Ñ 


c Oo uu du 


ooog 


Android 2.2 
Google APIs 
Android 2.3.1 
Google APIs 
Android 2.3.3 
Google APIs 
Android 3.0 
Google APIs 
Android 3.1 
Google APIs 
Android 3.2 
Google APIs 


Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 


Standard Android platform 1.5 


Properties 


Application name: 


Package name: 


DD ee ee NMMMIS RS 
9 9 = = O O ü 0 0 O S Ñ = 


Ú) Ú) e 一 


Led Control | 


|tw. com. damtek 


m 


Create Activity: ‘Led Control 
Min SDE Version: 


[7 


| 


D 


4) 点 击 “Finish” 按 钮 完成 创建 。 


(2) 添加 图 片 资源 


在 项 目 文件 列表 中 添加 如 图 5-9 所 示 图 


片 文件 。 


图 5-8 ”新 建 Android 项 


目 窗口 


NETT 


. png 
1 Con. png 


index. jpz 


E led. pnz 


ledott. bmp 


EHP ledon. bm 


图 5-9 添加 图 片 资源 


(3) 编辑 main.xml 文 件 ， 进 行 UI 设 计 


xml 文 件 的 程序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<RelativeLayout 

android: layout_width="fill parent" 

android:layout height-"fill parent" 

android: id="@+id/layout" 

xmlns:android-"http:// schemas.android.com/apk/res/android" 
> 

<ImageView 

android: src="@drawable/index" 

android:layout width-"wrap content" 

android:layout height-"wrap content" 

android: id="@+id/led_imageview" 

{> 

<TextView 

android: textSize="30px" 

android:layout width-"wrap content" 

android:layout height-"wrap content" 

android: textColor="#ffffffff" 

android: layout_centerHorizontal="true" 

android: id="@+id/led_text" 

android: layout_marginTop="20dip" 

android:text="Led Test" 

/> 

<TextView 

android: id="@t+id/led_position" 

android: layout_centerInParent="true" 

android: layout_width="50dip" 

android: layout height-"50dip" 

android:text= 
/> 
<TextView 
android: id="@+id/led_viewl" 

android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize-"20px" 
android:text-"D2 : " 

android:layout toLeftOf-"(-id/led myButtonl" 
android: layout_alignBaseline="@+id/led_myButton1" 
android: textColor="#ffffffff" Е 

/> 

<TextView 

android: id="@+id/led_view2" 

android: layout_width="wrap_content" 

android:layout height-"wrap content" 
android:textSize-"20px" 

android:text-"D5 : " 

android: layout_toLeftOf="@+id/led_myButton2" 
android: layout_alignBaseline="@+id/led_myButton2" 
android: textColor="#ffffffff" Е 

/> 

<Button 

android: id="@+id/led_myButton1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:background-"(drawable/ledon" 
android:layout toLeftOf-"(-id/led position" 


android: layout_above="@+id/led_position" 
/> 

<Button 

android:id="@+id/led myButton2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:background="@drawable/1ledon" 
android:layout toLeftOf-"(Mid/led position" 
android: layout_below="@+id/led_ position" 
/> 

<Button 

android: id="@+id/led_myButton1_1" 
android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:background-"6drawable/ledoff" 
android: layout_toRightOf="@+id/led_position" 
android: layout_above="@+id/led_position" 
/> 

<Button 

android: id="@+id/led_myButton2_1" 
android:layout width-"wrap content" 
android: layout_height="wrap_content" 
android:background="@drawable/ledoff" 
android: layout_toRightOf="@+id/led_position" 
android: layout_below="@+id/led_position" 
/> 

<Button 

android: id="@+id/led_myButton3" 

android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentTop-"true" 
android:layout marginLeft-"680px" 
android:background-"(drawable/back" 

{> 

</RelativeLayout> 


这 个 布局 中 包含 4 个 文本 框 和 5 个 按钮 ， 设 计 出 来 的 UI 如 图 5-10 所 示 。 


D 


open device success! 


45-10 ”LED 了 驱动 界面 


(4) Led_Controljava 程 序 代码 编写 


导入 相应 的 包 文件 : 


package tw.com.damtek; 

import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 


让 Led_Control 继 承 Activity: 


public class Led Control extends Activity 


定义 5 个 Button 并 声明 为 private 类 型 : 


private Button mButtonl; 
private Button mButton2; 
private Button mButton3; 
private Button mButton4; 
private Button mButton5; 
/* 定义 要 控制 LED 的 编号 */ 
public int statel-0,state2-0; 
/* 1 AR */ 

public int led on - 1; 
/* 2 AR */ 

public int led off = 0; 
public int fd - 0; 


定义 Button1 事 件 处 理 ， 调 用 本 地 方法 打开 标识 为 2 的 灯 : 


Private Button.OnClickListener buttonl listener- new 
Button.OnClickListener () 


{ 
public void onClick (View v) 


{ 

// 调用 SO 库 中 的 本 地 方法 
Linuxc.send(2, led_on); 
} 

1; 


定义 Button4 事 件 处 理 ， 调 用 本 地 方法 关闭 标识 为 2 的 灯 : 


private Button.OnClickListener button4 listener= new 
Button.OnClickListener () 


{ 
public void onClick (View v) 


{ 

// 调用 SO 库 中 的 本 地 方法 
Linuxc.send(2, led_off); 
} 

1; 


定义 Button5 事 件 处 理 ， 调 用 本 地 方法 关闭 标识 为 1 的 灯 : 


private Button.OnClickListener button5 listener- new 
Button.OnClickListener () 


{ 
public void onClick (View v) 


{ 

// 调用 SO 库 中 的 本 地 方法 
Linuxc.send(1, led_off); 
} 

1; 


定义 Button2 事 件 处 理 ， 调 用 本 地 方法 打开 标识 为 1 的 灯 : 


private Button.OnClickListener button2_listener= new 
Button.OnClickListener () 
{ 


public void onClick (View v) 


{ 

// 调用 SO 库 中 的 本 地 方法 
Linuxc.send(1, led on); 
} 

1; 


定义 Button3 事 件 处 理 ， 退 出 程序 ， 并 调用 本 地 方法 关闭 LED 驱 动 : 


private Button.OnClickListener button3_listener= new 
Button.OnClickListener () 


public void onClick (View v) 


{ 

/* 关闭 设备 文件 */ 
Linuxc.closeled(); 
/* 退出 应 用 程序 */ 
finish(); 

} 

1; 


实现 程序 第 一 次 启动 时 被 调用 的 方法 onCreate : 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 


显示 布局 文件 : 


setContentView (R.layout.main) ; 


调用 布局 文件 中 组 件 的 ID: 


mButtonl- (Button) findViewById (R.id.led myButtonl); 
mButton2 =(Button) findViewById(R.id.led myButton2); 
mButton3 =(Button) findViewById(R.id.led myButton3); 
mButton4 -(Button) findViewById (R.id.led myButtonl 1); 
mButton5 =(Button) findViewById(R.id.led myButton2 1); 


调用 SO 库 中 的 本 地 方法 ， 打 开 LED 驱 动 : 


fd = Linuxc.openled(); 

if (fd < 0){ 

setTitle("open device false!"); 
/* 车 打开 设备 失败 ,就 退出 */ 
finish(); 

} 

else { 

setTitle ("open device success!"); 
} 


使 用 setOnClickListener 监 听 事 件 : 


mButtonl.setOnClickListener(buttonl listener); 
mButton2.setOnClickListener(button2 listener); 
mButton3.setOnClickListener(button3 listener); 
mButton4.setOnClickListener(button4 listener); 
mButton6.setOnClickListener (button5 listener); 


(5) МІРА 87) У Јама 


右 击 项 目 图 标 ， 在 弹出 菜单 中 点 击 “New” 一 “Class”， 如 图 5-11 所 示 。 


El F> Led Control 
-j gg src 
i sem EL — 
ow d 2% Java Proje 


F3 Project... 


i Open in New Window 
Т assets Open Type Hierarchy 


a E res 


图 5-11 添加 一 个 类 


弹出 如 图 5-12 所 示 界 面 。 


填写 相应 信息 后 ， 点 击 “Finish” 按 钮 完成 创建 。 


编辑 Linuxc 这 个 Java 文 件 。 这 是 一 个 定义 了 本 地 方法 的 Java 类 ， 调 用 SO 库 。 程 序 代 码 如 下 所 示 : 


package tw.com.damtek; 

import android.util.Log; 

public class Linuxc { 

static { 

try { 

Log.i("JNI", "Trying to load libled.so"); 
/* 调用 libled.so Ж */ 

System. loadLibrary ("led") ; 

} 

catch (UnsatisfiedLinkError ule) { 
Log.e("JNI", "WARNING: Could not load libled.so"); 


}} 

/* 声明 openled () 为 本 地 方法 */ 

public static native int openled(); 

/* 声明 closeleq () 为 本 地 方法 */ 

public static native int closeled(); 

/* 声明 send () 为 本 地 方法 */ 

public static native int send (int led_num, int on_off); 
] 


通过 设计 底层 方法 来 实现 对 驱动 的 调用 。 若 已 有 使 用 事先 编译 的 SO 函数 库 及 JNI 函 数 ， 或 自行 编译 的 动态 链接 库 ， 首 先 将 libs\armeabiNlibled.so 这 个 文件 拷贝 到 项 目 目录 下 ， 如 图 5-13 所 示 。 请 注意 路 
径 必 须 维持 为 libs\armeabi\libled.so。 


— Hew Java Class 


Java Class 


Create a new Java class. 


Source folder: Led Control/sre 
pu 


[ JEnclosing type: Brows 


Name: 
Modifiers: | 1 ©) default private protected 
[ | abstraet [ | final static 


Superclass: Јата. lang. Obj ect 


Interfaces: 


Which method stubs would you like to create? 
[ ]public static yoid main(String[] args) 
[| |Constructors from superclass 


[^] Inheri ted abstract methods 
Do you want to add comments? (Configure templates and default value here) 


[Г] Generate comments 


вы) | 


85-12 填写 类 名 


Ey C:\apk_workspace\Led_ Control\libs\armeabi Alala 


CHO) 编辑 区) SEW KEW ТАФ TOM 


图 5-13 添加 SO 函数 库 
(6) 刷新 项 目 ， 添 加 编译 出 来 的 SO 中 间 库 文件 


选择 项 目 ， 按 F5 键 刷新 项 目 ， 如 图 5-14 所 示 。 


刷新 后 ， 工 程 中 的 SO 文件 如 图 5-15 所 示 。 


Java – Eclipse SDK (= | 


File Edit Run Source Navigate Search Project Refactor Window Help 


: [3 > ee n: x d FY | a? Java | 
H 0- Q- : #8 G-:@s- 
1а ul 


н xs zh- Yee Е 
= = Led Contr T 
由 8 src 
8-08 gen [G 

БА Androi Open in New Window 
GS assets Open Type Hierarchy F4 
a res Cine Th Alt+Shiftt# > 
[Ж dra 
9-65 dra B Copy Ctrl+C 
(> dra H Copy Qualified Name 
# (5 lay [È Paste CtrltV 


* & val X Delete Delete 
四 Androi 


defaul Build Path > 
Source AlttShiftt+S P 
Refactor AlttShift+T > 


Hew d 
Go Into 


ред Import... 
LÀ Export... 
w^" Refresh 
Close Project 
Assign Working Sets... 


Run As 
Debug As 


5-14 刷新 工程 


Java — Eclipse SDE 
File Edit Run Source Navigate Search Project Refactor Window Help 
: [E37 kee : : = JU d FS | & Java | 
: H- O7 а :9G-:5$- 
: H 5] о» c 


a es gen (Generated Java Files] 
mA Android 2. 1-updatel 
e assets 
@-@ jni 
= > libs 
=) 2 armeabi 
[7] libled. so 
@-@ obj 
= 2> res 
H (2 drawable-hdpi 
+ (2 drawable-ldpi 
Ы 2 drawable-mdpi 
+ (Ж layout 
= values 
Xl AndroidMani fest. xml 
B default, properties 


: [° Led_Control 


: Launching Demo, Motor 


图 5-15 ”在 工程 中 查看 SO 


(7) 生成 APK 


由 于 Eclipse 可 以 设 定 自动 编译 功能 ， 因 此 当 把 SO 复制 到 工程 目录 下 时 ， 它 也 已 经 编译 完成 了 。 生 成 的 APK 在 项 目 目录 的 bin 目 录 下 。 如 图 5-16 所 示 。 


m C:\apk_workspace\Led_Control\bin 
WFO RAO Bw бї) ITAW eon z 


Qa- © OX Jos (rex [Cu 
НИШ (0) 39 C: \epk_workspace\Led Control\bin vj #29] 


classes. dex 


РР РУТЕ X) ү Hyi DEX XU 
š 6 KB 


HERE ea Led Control. apk = "xg ap_ 


| АРК 立 件 AP ДУГ 
( Led Control 100 KB 90 KB 


5-16 Ж APK 


到 此 ， 完 成 了 LED 驱 动 程序 设计 。 
3.LED JNI 设 计 
(1) LED 的 SO 的 编写 
将 Led_Control 工 程 拷贝 到 读者 的 工作 目录 下 ， 工 作 目 录 为 CNapk_workspace\Led_ Control。 


(2) 编译 Java 文 件 成 C++ 语言 的 头 文件 


1) 在 “开始 ”菜单 中 点 击 “ 运 行 ”， 然 后 输入 “cmd” 进 入 DOS 命 令 提 示 符 窗口 ， 如 图 5-17 所 示 。 


- WE ERR. SS. MHS Internet 资源 的 名 
É PRs Windows HAFIR E. 


5-17 进入 DOS 


2) 进入 Ci\apk_workspace\Led_Control 目 录 下 ， 如 图 5-18 所 示 。 


s C:\WIRDOWS (syst en32Xcnd. exe 


‚: *apk uworkcpace*Led Control»dir 
Кел c 中 的 老 是 SYSTEH 
坟 的 序列 号 是 2820-7508 


C:\apk_worke pace\Led_Contrvol # OF 


2611-18-15 18:24 <DIR> е 
18:24 <DIR> òa 
14:59 : .claetpath 
14:59 -Project 
17:36 4 .settings 
15:2 Апі уп і dManifest—xml 
-13 17:36 assets 
811-10-13 17:59 bin 
2011-82-16 14:59 х default properties 
2011-18-15 17:36 gen 
2011-10-13 17:36 res 
d 17:36 1 src 
а 2.170 тра 


: aapk vorkspace \Led_Control?_ 


5-18 进入 LED 工 程 目录 


3) 建立 一 个 名 称 为 jni 的 目录 ， 然 后 进入 jni 目 录 ， 如 图 5-19 所 示 。 


>-Napk_works расе \Led_Controlomd jni 


:\apk_workspaceLed_Control>cd jni 


C: sapk workspace SLed_Control\jni> 


15-19 ”建立 jni 目 录 


jni 这 个 目录 用 于 存放 C 及 C++ 原 始 程 序 代码 文件 ， 以 及 要 编译 这 些 程序 代码 的 脚本 文件 。 


4) 执行 命令 “javah-classpath “C:\apk_workspace\Led_Control\bin” tw.com.damtek.Linux” , 


如 图 5-20 所 示 ， 在 当前 目录 jni 下 生成 一 个 tw_com_damtek_Linuxc.h 文 件 。 


INDOS \syst om32\ cud. оне 


: \apk_uorkspace Led Control»md jni 
Jt wapk_vorkepace \Led_Control>cd jni 


: Napk_vorkspace SLed_Control\jnidjavah classpath "C:\apk_vorkspace Led Control 


in" tw.con.damtek.Linuxc 


ace SLed_Control\jniddir 
2 аз | 是 SYSTEM 


列 号 是 982C-759B 


C:*apk uorkspaceNLed Controlwjni 的 目录 


2011-18-15 17:44 <DIR> à 
2011-10-13 17:44 <DIR> € 
8811-18-13 17:44 881 tw_con_damtek_Linuxe .h 
TX 891 == т 
目录 65,158 ,852,608 可 用 字 节 


NapDpKk_wDbhKksDpaceDed Gontrol\ ni>, 


5-20 ”生成 头 文件 


(3) 编写 调用 C+ + 语言 头 文件 的 C 程 序 代码 


5 程序 代码 创建 一 个 tw_com_damtek_Linuxc.cpp 文 件 ， 实 现 tw_com_damtek_Linuxc.h 这 个 头 文件 中 定义 的 函数 ， 其 程序 代码 如 下 。 


定义 头 文件 : 


#include <jni.h> 

#include "tw com damtek Linuxc.h" 
dinclude <stdio.h> ш 
#include <stdlib.h> 

finclude <fcntl.h> 

#include <errno.h> 

#include <unistd.h> 

#include <sys/ioctl.h> 

#include <string.h> 


定义 相应 的 宏 : 


#define LED TEST 3 
#define DEVICE_BLTEST "/dev/led" 


定义 变量 : 


int fd; 


实现 本 地 方法 openled: 


JNIEXPORT jint JNICALL Java tw com damtek Linuxc openled 
(JNIEnv *env, jclass mc) 

{ 

fd= open(DEVICE BLTEST,O RDONLY); 

return fd; 

} 


实现 本 地 方法 closeled: 


JNIEXPORT jint JNICALL Java tw com damtek Linuxc closeled 
(JNIEnv *env, jclass mc) 


{ 
close (Ёа); 
l 


实现 本 地 方法 send : 


JNIEXPORT jint JNICALL Java_tw_com_damtek_Linuxc_send 
(JNIEnv *env, jclass mc, jint a, jint b) 


{ 
ioctl(fd,b,&a); 
} 


定义 类 名 : 


static const char *classPathName = "tw/com/damtek/Linuxc"; 


关联 本 地 方法 ， 连 接 实现 与 接口 ， 第 一 个 参数 为 本 地 方法 接口 ， 第 二 个 参数 为 参数 与 返回 类 型 ; 


static JNINativeMethod methods [] 
{"openled", "()Ljava/lang/String; 
(void*) Java_tw_com_damtek_Linuxc_openled}, 
{"closeled", "()Ljava/lang/String;", 

(void*) Java_tw_com_damtek_Linuxc_closeled}, 
{"send", "()Ljava/lang/String;", 

(void*) Java_tw_com_damtek_Linuxc_send}, 

H 


注册 本 地 方法 : 


/* 
* Register several native methods for one class. 

E 

static int registerNativeMethods (JNIEnv* env, const char* className, 
JNINativeMethod* gMethods, int numMethods) 

{ 

jclass clazz; 

clazz = env-»FindClass (className) ; 

if (clazz == NULL) { 

fprintf(stderr, "Native registration unable to find class 

'$s'", className) ; 

return JNI_FALSE; 


if (env->RegisterNatives (clazz, gMethods, numMethods) < 0) { 
fprintf(stderr, "RegisterNatives failed for '$s'", 
className) ; 

return JNI_FALSE; 

} 

return JNI_TRUE; 

} 

/* 

* Register native methods for all classes we know about. 
* 

* returns JNI_TRUE on success. 

Б 

static int registerNatives (JNIEnv* env) 

{ 

if (!registerNativeMethods (env, classPathName, 
methods, sizeof (methods) / sizeof (methods[0]))) { 
return JNI FALSE; 

} 

return JNI_TRUE; 

} 

typedef union { 

JNIEnv* env; 

void* venv; 

} UnionJNIEnvToVoid; 

jint JNI OnLoad(JavaVM* vm, void* reserved) 

{ 

UnionJNIEnvToVoid uenv; 

uenv.venv = NULL; 

jint result = -1; 

JNIEnv* env = NULL; 

printf ("JNI_OnLoad") ; 


if (wm-»GetEnv(&uenv.venv, JNI VERSION 1 4) != JNI OK) { 
fprintf(stderr, "ERROR: GetEnv failed"); 

goto bail; 

} 

env = uenv.env; 

if (registerNatives (env) != JNI TRUE) { 

fprintf(stderr, "ERROR: registerNatives failed"); 

goto bail; 


} 

result = JNI VERSION 1 4; 
bail: 

return result; 


} 


(4) 创建 生成 SO 的 配置 文件 


现在 jni 目 录 下 已 经 有 tw_com_damtek_Linuxc.cpp 和 tw_com_damtek_Linuxc.h 这 两 个 文件 。 还 需要 添加 一 个 脚本 文件 实现 编译 链接 ， 其 文件 名 称 为 Android.mk， 其 代码 如 下 : 


LOCAL_PATH := $(call my-dir) 

include $(CLEAR VARS) 

LOCAL MODULE := led 

LOCAL SRC F ILES := tw com damtek Linuxc.cpp 
include $(BUILD SHARED LIBRARY) 


(5) 生成 SO 动态 链接 库 


打开 Cygwin 终 端 ， 进 入 Ci\apk_workspace\Led_Control 目 录 ， 然 后 执行 “ndk-build” 命 令 即 可 。 如 图 5-21 所 示 。 


- /cygdrive/c/apk workspace/Led Control 


cd C: 


- ygdr ive i> 


cd арк workspace 


‘cyugqdrive/c/apk 


cd Led_Control/ 


C ygd riuc/c^a p k 


ndk-build 


Compile++ thumb : led <= twv com damtek Linuxc.cpp 
StaticLibrary libstdc++.a 


haredLibrary libled.so 


Install libled.so => libs/armeabi/libled.so 


/cygdrive/c/apk_workspace/Led_Cont 


图 5-21 ”编译 SO 


测试 自己 编写 的 LED 控 制程 序 ， 步 又 如 下 : 


1) 打开 DMA-210XP 平 台 的 电源 ， 启 动 系统 ， 把 编译 处 理 的 ko 文件 拷贝 到 SD 卡 的 LED 目 录 下 ( 若 没 有 请 建立 ) ， 把 SD 卡 插入 实验 平台 。 


2) 打开 PC 上 的 串 行 口 工 


zrol 


Secure CRT5.0 或 者 其 他 的 串 行 口 工具 ， 将 生成 的 驱动 添加 到 Android 系 统 中 ， 打 开 串 行 端口 工具 输入 如 下 命令 ， 进 入 SD 卡 的 led 目 录 : 


#cd sdcard 

#cd led 

# pwd 
/ѕасага/1еа 

# insmod 1еа. ко 


LED driver register success! 
# busybox mknod /dev/led c 230 0 


3) 安装 APK。 将 生成 的 APK 拷 贝 到 SD 卡 下 的 APK 目 录 中 ( 若 没有 请 建立 ) ， 将 SD 卡 插入 DMA-210XP 实 验 平台 。 


找到 存储 APK 的 目录 ， 点 击 进入 找到 我 们 要 的 APK。 如 图 5-23 所 示 。 


点 击 “DMAFM 文 件 管理 器 ”这 个 


图 标 执行 文件 管理 器 ， 如 图 5-22 所 示 。 


PN = 


— Edi REL 
— Android 


== АРК 
— bluetooth 


2 点击 APK 的 目录 


l | 8:16 


Led_Control.apk 


95.03KB 


图 5-23 ”找到 我 们 要 的 APK 
点 击 安装 ， 如 图 5-24 所 示 。 
点 击 “ 打 开 ” 将 进入 程序 ， 也 可 以 点 击 “ 完 成 。。 这 里 我 们 选择 “完成 ”。 


4) 打开 安装 好 的 LED 控 制 的 应 用 程序 ， 如 图 5-25 所 示 。 


应 用 程序 已 安装 


图 5-24 应 用 程序 安装 完成 


45-05 ”打开 LED 控 制 的 应 用 程序 


5) 点 击 D2 处 的 亮 按钮 ， 观 察 DMA-210XP 平 台 的 D2 LED 灯 是 否 被 点 亮 ， 熄 灭 按钮 


也 是 ， 这 样 来 测试 程序 是 否 正 确 。 观 察 实验 平台 的 D2 灯 的 亮 灭 。 


S5PV210 由 5 个 32 位 脉冲 宽度 调制 (PWM) 定时 器 组 成 ， 这 些 定时 器 用 来 产生 内 部 中 断 到 ARM 子 系统 。 另 外 ， 定 时 器 0~ 3 包含 一 个 可 以 驱动 外 部 MO 信号 的 PWM 功能 。 在 定时 器 0 中 ，PWM 有 一 个 可 


选 的 死 区 发 生 器 ， 支 持 大 电流 设备 。 定 时 器 4 是 一 个 无 输出 引 脚 的 内 部 定时 器 。 


定时 器 使 用 APB-PCLK 作 为 时 钟 源 。 定 时 器 0 和 1 共享 一 个 可 编程 的 8 位 预 分 频 器 ， 它 提供 了 为 PCLK 第 一 个 层次 的 划分 。 定 时 器 2、3 和 4 共享 另外 的 8 位 预 分 频 器 。 每 一 个 定时 器 都 拥有 自己 的 可 以 生产 第 
二 个 层次 划分 的 时 钟 分 频 器 ( 预 分 频 器 由 2、4、8 或 16 进 行 分 频 ) ; 或 者 ， 定 时 器 可 以 选择 来 自 CMU 的 时 钟 源 。 定 时 器 0、1、2、3 和 4 选择 SCLK_PWM。 


每 个 定时 器 都 拥有 由 定时 时 钟 驱 动 的 32 位 递减 计数 器 ， 这 个 递减 计数 器 最 初 加 载 来 自 定 时 器 计数 缓冲 寄存 器 TCNTBn。 如 果 递减 计数 器 到 达 0 值 ， 那 么 产生 定时 器 中 断 请 求 ， 通 知 CPU 定 时 器 操作 已 经 完 
成 。 如 果 定 时 器 递减 计数 器 到 达 0 值 ，TCNTBn 相 应 的 值 自动 重新 加 载 到 递减 计数 器 ， 以 开始 下 一 个 周期 。 然 而 ， 当 由 于 某 种 原因 定时 器 停止 工作 时 ， 如 在 定时 器 运行 模式 下 ， 通 过 清空 定时 器 的 使 能 位 
TCONn，TCNTBn 的 值 将 不 能 被 加 载 到 计数 器 上 。 


2.PWM 操 作 


(1) 预定 标 器 与 分 配器 


一 个 8 位 的 预 分 频 器 和 3 位 分 配器 产生 下 面 的 输出 频率 ， 如 表 5-17 所 示 。 


ASAT 定时 器 最 大 、 最 小 输出 周期 


ы НЫЗ 最 低 分 辩 率 最 高 分 辩 率 最 大 间隔 
„юка (prescaler=1 ) (prescaler=255 ) (TCNTBn=4294967295 ) 


TI(PCLK=66M 1665927 
VAPCLK-GGME) "TES 
VAPCLK-GGMI) $6637.07 
Va(PCLK=66ME Tm 
1Л(РСЕК-—66МН) —À 


(2) 定时 器 的 基本 操作 


其 操作 的 基本 流程 如 图 5-26 所 示 。 


йе = | 计时 器 开始 | [TCNTn = TCMPn TCNTn =TCMPn| [计时 器 停 正 


TCMPn 1 0 


TCNTn 


TCNTBn=3 TCNTBn=2 

TCMPBn=1 TCMPBn=0 
手机 更 新 =1 手机 更 新 =0 
自动 重 载 =1 自动 重 载 =1 


TOUTn 


图 5-26 ”定时 器 的 操作 


定时 器 ( 除 定时 器 通道 4) 包括 TCNTBn、TCNTn、TCMPBn 和 TCMPn。 当 定时 器 置 “0” 时 ，TCNTBn 和 TCMPBn 载 入 TCNTn 和 TCMPn 中 。 当 TCNTn 置 “0” 时， 如 果 中 断 信号 启动 ， 则 将 产生 中 断 
请 求 。 (TCNTn 和 TCMPn 是 内 部 寄存 器 的 名 称 。 可 以 从 TCNTOn 寄 存 器 中 读 取 TCNTn 寄 存 器 ) 。 


(3) 定时 器 操作 实例 


显示 下 列 程序 的 结果 ， 如 图 5-27 所 示 。 


@ 启 用 自动 重新 载 入 功能 。 设 置 TCNTBn 为 160 (50+110) ，TCMPBn 为 110。 设 置 手动 更 新 位 和 反 转 位 ( 开 / 关 ) 。 该 手动 更 新 位 设置 TCNTn 和 TCMPn 为 TCNTBn 和 TCMPBn 的 值 。 然 后 ， 设 置 
TCNTBn 和 TCMPBn 作 为 80 (40+40) 和 40， 以 确定 下 一 个 重新 载 入 的 值 。 


@ 当 TCNTn 和 TCMPn 有 相同 值 时 ，TOUTn 的 逻辑 电 平 由 低 变 为 高 。 


@ 当 TCNTn 达 到 “0” 时 ，TCNTn 和 TCNTBn 自 动 重 装 。 在 同一 时 间 产 生 中 断 请 求 。 


@ 在 ISR (中 断 服务 程序 ) 中 ，TCNTBn 和 TCMPBn 被 设置 为 80 (60+20) 和 60， 它 被 用 于 下 一 个 持续 时 间 。 


@ 当 TCNTn 和 TCMPn 有 相同 值 时 ，TOUTn 的 逻辑 电 平 由 低 变 为 高 。 


@ 当 TCNTn 达 到 “0” 时 ，TCNTn 和 TCNTBn 自 动 重 装 。 在 同一 时 间 产 生 中 断 请 求 。 


@ 在 ISR (中 断 服务 程序 ) 中 ， 自 动 重新 载 入 并 中 断 请 求 被 禁止 ， 以 便 停止 定时 器 。 


@ 当 TCNTn 和 TCMPn 有 相同 值 时 ，TOUTn 的 逻辑 电 平 由 低 变 为 高。 


@ 当 TCNTn 达 到 “0” 时 ，TCNTn 没 有 任何 更 多 的 重 载 ， 因 为 自动 重 载 禁止 而 使 定时 器 被 停止 。 


TOUTn 
110 


Un 
о 
+ 
© 


40 


ол Po 
一 一 — BEEN 


图 5-27 定时 器 的 操作 实例 


(4) PWM ( 脉 宽 调制 ) 


PWM 功能 应 执行 TCMPBn。TCNTBn 决 定 PWM 的 频率 。TCMPBn 决 定 PWM 的 值 ， 如 图 5-28 所 示 。 


60 


STCMP Bn—60| "jTCMPBn—40! "jTCMP Bn=30 
TCMP Вп= 50 TS ТСМР Вп =30 ETCMP Bn 


Ep PWM 


5-28 PWM 的 实例 


因为 有 较 高 的 PWM 值 ， 所 以 减少 TCMPBn 值 。 因 为 有 较 低 的 PWM 值 ， 所 以 增加 TCMPBn 值 。 如 果 逆 变 器 输出 启用 ， 递 增 /递减 可 能 会 适得其反 。 由 于 双 缓冲 的 特性 ， 对 于 下 一 个 PWM 周 
期 ，TCMPBn， 可 以 通过 ISR 被 写 入 当前 PWM 周期 的 任何 一 端 。 


3.PWM 专 用 寄存 器 
PWM 定时 器 的 特殊 功能 寄存 器 如 表 5-18~ 表 5-24 所 示 : 
(1) 定时 器 配置 寄存 器 (TCFG0， 读 / 写 ， 地 址 =0xE250 0000) 
定时 器 输入 时 钟 频率 =PCLK/ ( 癸 分 频 器 值 +1}) /{ 分 配置 值 } 
{ 倾 分 频 器 值 }j=1~255 


{分 配器 值 }=1, 2, 4, 8, 16, TCLK 


FERRE =0~254 


表 5-18 定时 器 配置 寄存 器 TCFG0 


TCFGO 初始 状态 
Dead zone length 死 区 的 长 度 0x00 
Prescaler | 0x01 


Prescaler 0 [7:0] 读 / 写 定时 需 0 和 1 预 分 频 帮 1 值 0x01 


(2) 定时 器 配置 寄存 器 (TCFG1， 读 / 写 ， 地 址 =O0xE250_ 0004) 


表 5-19 定时 器 配置 寄存 器 TCFG1 


TCFG1 初始 状态 
Reserved | png | 一 | ft 0x00 


选择 定时 器 4 的 MUX 输入: 


Divider MUX 4 [19:16] eve 0x00 
0100: 1/16 0101: 外 部 TCLK1 
选择 定时 器 3 的 MUX 输入 : 

Dvdr MUX ШШ noo 
0100: 1/16 0101: 外 部 TCLK1 
选择 定时 器 2 1 MUX 输入 : 

Divider MUX | M Т 
0100:1/16 0101: 外 部 TCLK1 
选择 定时 器 1 AY MUX 输入 : 

Divider MUX (A noo 
0100: 1/16 0101: 外 部 TCLK1 
选择 定时 器 0 的 MUX 输入 : 

Dvdr мохо К noo 
0100:1/16 0101: 外 部 TCLK1 


ik: 如 果 使 用 SCLK_PWM， 则 TOUT 可 以 表明 最 小 误差 ， 在 PWM 模块 下 ， 通 过 PCLEK 可 以 使 SCLK_PWM 被 简化 。 但 是 SCLK_PWM 和 PCLK 是 异步 时 钟 。 因 此 在 精确 时 间 区 SCLK_PWM 是 不 可 被 简化 的 。 
当 SCLK_PWM 比 PCLK 慢 时 ， 最 小 误差 可 以 被 减 小 。 所 以 ， 推 荐 使 用 SCLK_PWM 低 于 1mhz。 


例如 : 如 果 PCLK 是 66MHz 并 且 SCLK_PWM 是 1MHz， 责 任 误差 是 1.5%。 如 果 PCLK 是 66MHz 并 且 SCLK_PWM 是 0.5MFHz， 责 任 误差 是 0.75%。 
(3) 定时 器 控制 寄存 器 (TCON,， 读 / 写 ， 地 址 =0xE250_0008) 


4520 ”定时 器 控制 寄存 器 


тоон = 


. : 确定 定时 器 4 的 手动 更 新 
Timer 4 Manual Update (note) [21] 读 / 写 0x0 
0= 无 操作 ”1= 更 新 TCNTB4 
确定 定时 器 4 的 启动 /停止 
Timer 4 Start/Stop [20] i / = din 0х0 


| 确定 定时 器 3 的 自动 加 载 开 / 关 
Timer 3 Auto Reload on/off [19] 0x0 


0=One-shot 1= 间隔 模式 (AJER) 


确定 定时 器 3 的 输出 反 转 器 开 / 关 

Timer 3 output inverter on/off [18] 0x0 
0= 逆 变 器 关闭 ”1= 逆 变 器 开 ， 用 于 TOUT3 
确定 定时 器 3 的 手动 更 新 

Timer 3 Manual Update (note) [17] ET 

iS 


0= 无 操作 1= 更 新 TCNTB3 或 CMPB3 


| аю 
Timer 3 Start/Stop [16] 0x0 
0= 停止 
确定 定时 器 2 的 自动 加 载 开 / 关 
Timer 2 Auto Reload on/off [15] 、 e 0x0 
0-One-shot 1= 间隔 模式 (自动 重 载 ) 


确定 定时 器 2 的 输出 反 转 器 开 / X< 


Timer 2 Output Inverter on/off [14] Eu 0x0 


0= 道 变 器 关闭 ”1= 道 变 器 开 ， 用 于 TOUT2 


WARE EN 2 的 手动 更 新 

Timer 2 Manual Update (note) [13] 0x0 
0= 无 操作 1= 更 新 TCNTB2 或 TCMPB2 

| f 确定 定时 器 2 的 启动 /停止 

Timer 2 Start/Stop [12] 读 / 写 0х0 
0= 停 止 1= 启动 
确定 定时 器 1 的 自动 加 载 开 / 关 

Timer 1 Auto Reload on/off [11] 0x0 
0=One-shot 1= 间隔 模式 (自动 重 载 ) 


确定 定时 器 1 的 输出 反 转 器 开 / 关 


Timer 1 Output Inverter on/off [10] 读 / 写 0x0 


0= 逆 变 需 关 闭 1= WRR, HF TOUTI 


确定 定时 器 1 的 手动 更 新 
Timer 1 Manual Update (note) / 写 0x0 
0= 无 操作 1= 更 新 TCNTBI sË TCMPBI 


确定 定时 器 1 的 启动 /停止 
Timer 1 Start/Stop [8] 读 / 写 0х0 
0= 停 止 1= 启 动 


"IS 确定 死 区 的 操作 
Dead Zone Enable [4] 读 / 写 0x0 
0= #1 1= 使 能 


确定 定时 器 0 的 自动 加 载 开 / 2 

0=One-shot 1= 间隔 模式 (自动 重 载 ) 

确定 定时 器 0 的 输出 反 转 器 开 / 关 

0= WEAR] 1= 逆 变 器 开 ， 用 于 TOUTO 
确定 定时 器 0 的 手动 更 新 

0= 无 操作 1= 更 新 TCNTB0 或 TCMPB0 
确定 定时 器 0 的 启动 /停止 

0= 停 止 1= 启 动 


Timer 0 Auto Reload on/off 


Timer 0 output inverter on/off 0x0 


Timer 0 Manual Update (note) 0x0 


Timer 0 Start/Stop 0x0 


(4) TCNTB0 定 时 器 0 计数 寄存 器 (TCNTB1, TCNTB2, TCNTB3, TCNTB4) 


表 5-21 TCNTB0 定 时 器 0 计数 寄存 器 


a f 器 地 
TCMPBO 0x7F006010 


TCNTBO 


Timer 0 Count Buffer 


(5) TCMPB0 定 时 器 0 比较 寄存 器 (TCMPB1, TCMPB2, TCMPB3) 


表 5-22 TCMPB0 定 时 器 0 比较 寄存 器 


地 


0x7F00600C 


(6) TCNTO 0 定时 器 0 计数 观察 寄存 器 (TCNTO1、TCNTO2、TCNTO3、TCNTO4) 


表 5-23 TCNTO 0 定时 器 0 计数 观察 寄存 器 


a f 器 
TCNTO0 
TCNTOO 


Timer 0 Count Observation 


(7) TINT_CSTAT (定时 器 中 断 控制 和 状态 寄存 器 ) 
表 5-24 定时 器 中 断 控制 和 状态 寄存 器 
т f 器 复 位 值 
INT_CSTAT 0x7F006044 定时 器 中 断 控 制 和 状态 寄存 器 x0000 0000 


(Ж) 


TINT_CSTAT 位 读 / = fü jË 初始 状态 
Reserved [31: 10] 0x00000 
Timer 4 Interrupt Status [9] 0x0 
Timer 3 Interrupt Status [8] 0x0 
Timer 2 Interrupt Status | [7] Be / 写 EMT RE 2 中 断 状 态 位 。 通 过 写 清除 i 0x0 
Timer | Interrupt Status [6] 0x0 


Timer 0 Interrupt Status | [5] БЕ / 写 态 “1 ”清除 该 位 | 0х0 
定时 器 4 中 断 启动 。 


Timer 4 interrupt Enable | [4] 1: 启动 0: b 0x0 
Timer 3 interrupt Enable | [3] e ra 0x0 
Timer 2 interrupt Enable | [2] ae E MR 0x0 
Timer 1 interrupt Enable | [1] i d ín: 0х0 
Timer 0 interrupt Enable | [0] 定时 器 0 中 断 局 动 。 0x0 


1: 启动 0: 禁止 


5.3.2 ”背光 接口 电路 


1. 背 光 接 口 电路 


把 GPIO 接 口 的 GPD0 0 连接 到 控制 背光 的 信号 引 脚 ， 通 过 PWM 控制 脉 宽 调制 信号 占 空 比 ， 使 它 输出 所 需 的 脉 宽 调制 信号 ， 控 制 输出 电压 的 大 小 。 背 光 接 口 电 路 如 图 5-29 所 示 。 


PWM Timer XpwmTOUTO/GPDO 0 "59 — —— e, pwmOUTO 


XpwmTOUT1/GPDO 1 as | > РМТООТІ 
(VDD EXTO) | | pwmOUT2 


онш 
XpwmTOUT3/PWM MIE/GPDO 3 | > pwmOUT3 


c wo o o 


图 5-29 ”背光 接口 电路 


2. 背 光驱 动 程序 分 析 


在 背光 驱动 程序 中 ， 要 实现 对 LCD 背 光亮 度 的 调节 ， 主 要 完成 3 个 操作 ， 接 下 来 详细 分 析 。 


(1) 注册 驱动 设备 并 开启 时 间 控制 器 Timer0 


设备 驱动 的 注册 很 简单 ， 直 接 引 


register_chrdev 函 数 即 可 。 关 于 主 设备 号 和 设备 节点 的 选择 ， 读 者 可 以 根据 需要 自行 设置 。 代 码 如 下 : 


retval = register_chrdev(BL_MAJOR,bl_name, &bk_light_fops) ; 


在 成 功 注册 背光 驱动 后 开启 控制 PWM 的 时 间 控 制 器 Timer0， 代 码 如 下 : 


gpio init(0,255 * 78770 / 255,78770); // 0 的 定义 就 是 开启 Timer0 


(2) 驱动 PWM ， 完 成 对 PWM 的 初始 化 配置 


驱动 PWM ， 主 要 是 对 PWM 定时 器 、 比 例 因子 、 分 频 缓存 器 和 对 应 的 GPIO 进 行 配置 ， 并 开启 PWM 设备 和 时 间 控 制 器 ， 相 关 程 序 代码 如 下 : 


static void gpio init(int id, int duty ns, int period ns) 


{ 

/* 初 始 化 GPIO 引 脚 */ 

/* BACK LIGHT GPB1*/ 

unsigned long tcon; 

unsigned long tcnt; 

// long tcmp; 

unsigned long tcfgl; 

unsigned long tcfg0; 

s3c gpio cfgpin(S5PV210 GPD0(0), S5PV210 GPD 0 0 TOUT 0); 
S3c gpio setpull(S5PV210 GPD0(0), S3C GPIO PULL NONE); 
tcfgl = raw readl(S3C2410 ТСЕС1); 

tcfgl &= -S3C2410 ТСЕСІ MUXI MASK; 

tcfgl |= S3C2410 TCFG1 MUX1 DIV2; // 25M 

tcfgO &- ~$3C2410_TCFG_PRESCALERO_MASK; 

tcfgO |= 4 << 0; 

tcon &= ~ (7<<0); 

tcon |= S3C2410 TCON TORELOAD; 


tcfg0 = raw readl(S3C2410 TCFGO) ; 
tcfg0 &= ~$3C2410_TCFG_PRESCALERO_MASK; 
tcfgO |= (32<<0); 
raw writel(tcfgl, 53С2410 ТСЕС1); 
— raw writel(tcfg0, S3C2410 TCFG0); 
raw writel(tcon, S3C2410 TCON); 
Tent =( 96000000 )/( FREQ PWM3 *16 ); 
raw writel(tcnt, S3C2410 TCNTB(id)); 
— raw writel(((tcnt*(20))/100), S3C2410 TCNTB (id)); 
tcon = raw readl(S3C2410 TCON); 
x2;// tcon |= pwm tcon manulupdate (pwm) ; 
tcon|=0x4;// tcon |= pwm tcon invert (pwm); 
tcon|=0x8;// соп |= pwm tcon autoreload (pwm) ; 
. raw writel(tcon, S3C2410 TCON); 
tcon &- ~(1<<1);// tcon &= ~ рит tcon manulupdate (pwm) ; 
. raw writel(tcon, S3C2410 TCON); 
// set enable 
tcon = raw readl(S3C2410 TCON); 
tcon |= Oxl; = 
raw writel(tcon, S3C2410 TCON); 
return 0; Е 


} 


(3) 实现 与 应 用 程序 的 连接 ， 能 够 通过 应 用 程序 实现 调节 背光 


作为 Linux 字 符 驱 动 设备 ， 背 光驱 动 程序 也 提供 了 ioctl 函 数 ， 以 完成 与 应 用 程序 的 连接 。ioctl 函 数 的 代码 如 下 : 


static int bk_light_ioctl(struct inode *inode, struct file *file, 
unsigned int cmd, unsigned long arg) 

{ 

int ret = 0; 

int value; 

ret = copy from user(&value, (int*)arg, sizeof (int)); 

printk ("cmd=%d\n", cmd) ; 

switch (cmd) 


{ 

case BK LIGHT DOWN: 
status — DOWN; 

DUTY --STEP; 

if (DUTY<12) 

DUTY=12; 

set_pwml (DUTY) ; 

printk ("ВК LIGHT DOWN\n") ; 
break; » Е 

case BK LIGHT UP: 

status = UP; 

DUTY +=STEP; 

if (DUTY>MAX VAL) 
DUTY-MAX VAL; 

set pwml (DUTY); 

printk("BK LIGHT ОР\п"); 
break; 

case BK LIGHT SET: 

if (value>MAX VAL) 


{ 

DUTY=MAX_VAL; 
set pwm1 (DUTY) ; 
} 


else 


{ 

if (value<0) 

{ 

DUTY=0; 

set_pwml (DUTY) ; 
} 

else 

{ 

set_pwml (value) ; 
} 

} 

printk ("BK_LIGHT_SET\n") ; 
break; 

default : 

break; 


return 0; 


} 


为 了 使 PWM 可 以 实时 地 调整 其 输出 的 波形 ， 即 背光 亮度 ， 驱 动 还 提供 如 下 一 个 函数 : 


static void set pwml(int hiratio) 


unsigned long tcnt; 

tent =( 96000000 )/( FREQ PWM3 *16 ); 

printk ("hhh=%d\n", hiratio) ; 

. raw writel(((tcnt* (hiratio) ) /100), 53С2410 TCNTB(0)) ; 
} 


3. 背 光驱 动 程序 的 Makefile 


关于 背光 驱动 程序 的 Makefile 参 见 6.1.3 节 中 的 介绍 。 


4. 背 光驱 动 编译 


使 用 “make” 命 令 编译 背光 驱动 程序 。 如 图 5-30 所 示 。 


5.3.3 ”背光 驱动 程序 设计 


1 背光 界面 设计 


在 前 一 小 节 设 计 出 了 驱动 程序 ， 本 小 节 主 要 介绍 如 何 设计 应 用 界面 以 进行 背光 明亮 度 控制 。 具 体 步骤 如 下 。 


(1) 新 建 工程 项 目 


IR] 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 


5-31 所 示 菜 单 。 


ach@ubuntu:~/dme210xp bock/ch08/exam02/backlight/Driver Source/backlight$ make 
make -C /home/ach/dma210xp book/ch4/android kernel 2.6.35 dma210xp M=/home/ach/dma210xp book/c 
m82/backlight/Driver Source/backlight modules 
make[1]: Entering directory "/home/ach/dma218xp book/ch4/android kernel 2.6.35 dma210xp' 

CC [M] /home/ach/dma210xp book/ch88/exam02/backlight/Driver Source/backlight/bk light.o 
/home/ach/dma21€xp book/ch88/exam82/backlight/Driver Source/backlight/bk light.c: In function 
nit: 


/home/ach/dma21€xp book/ch88/exam82/backlight/Driver Source/backlight/bk Light.c:195; warning: 
' is used uninitialized in this function 


/home/ach/dma21€xp book/ch88/exam92/backlight/Driver Source/backlight/bk light.c:197: warning: 
' is used uninitialized in this function 

Building modules, stage 2. 

MODPOST 1 modules 

CC /hone/ach/dma210xp book/ch08/exam02/backlight/Driver Source/backlight/bk light.mod.o 

LD [M] /home/ach/dma210xp bock/ch08/exam02/backlight/Driver Source/backlight/bk Light.ko 
make[1]: Leaving directory /home/ach/dma210xp book/ch4/android kernel 2.6.35 дта210хр' 
acliguburnLu:-/dmc210&p buuh/«li00/cxam02/bachligbL/Drivecr: Suurce/backlighls i 


5-30 ”编译 背光 了 驱动 程序 


AlttShifttW P 


Ltrl+L 


CtrltV 
Delete 


5-31 + Package Exploret 的 空白 处 


2) 在 弹出 菜单 中 选择 “New” 一 “Project”， 弹 出 如 图 5-32 所 示 窗 口 。 


3) 选择 “Android” 一 “Android Project”， 点 击 “Next” 按 钮 。 弹 出 如 图 5-33 所 示 窗 口 ， 在 相应 位 置 填 入 信息 。 


-E Java Project from Existing Ant Buildfile 
eg Plug-in Projact 


* Android Test Project 
8 Android XML File 
pS cvs 
-S Tava 
PERS Plug-in Development 
80-5 User Assistance 


图 5-32 ”新 建 工程 项 目 窗口 


Hew Android Project 


New Android Project 


Creates a new Android Project resource. 


Project name: Backlight Control 


Contents 


(=) Create new project in workspace 


Q Create project from existing source 
[7]Use default location 


Create project from existing sample 


Samples: ApiDemos 


Build Target 


р 
p 


Vendor 


Target Name 
C] Android 1.5 
E] Google API= 
C] Android 1.6 
[] Google APIs 


Cosel kets 


C] Android 2.2 
[] Google APIs 


C] Android 2.3. 


[] Google APIs 


C] Android 2.3. 


[] Google APIs 
C] Android 3.0 
[] Google APIs 
C] Android 3.1 
[] Google APIs 
C] Android 3.2 
[] Google APIs 


Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 
Google Inc. 


Android + Google APIs 


Properties 


OWWWOUUNNN е = ee 
Ñ = = O O Q Q) Q) Q) N N — Ë 


ооли 


Backlizht Control 
com. tw. dmatek. dma210xp. backlight 
[7] Create Activity: |Backlizht Control 


Application name: 


Package name: 


Min SDK Verzion: 


@ 


图 5-33 ”新 建 Android 项 目 窗口 


4) 点 击 “Finish” 按 钮 完成 创建 。 


(2) 添加 图 片 资源 


在 项 目 文件 列表 中 添加 如 图 5-34 所 示 图 片 文件 。 


(=) drawable-mdpi 


| btn minus pressed. pnz 


btn_minus. png 


btn_plus pressed. png 
btn plus. png 


1COIL. DILE 


5-34 添加 图 片 资源 
(3) 编辑 main.xml 文 件 ， 进 行 UI 设 计 


xml 文 件 的 程序 代码 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android="http: 
android: orientation="vertical" 

android: layout_width="fill parent" 
android: layout_height="fill parent" 

> 

<TextView 

android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android:gravity-"center horizontal" 
android:text-"BackLight Test" 
android:textSize-"35dip" 

/> 

<LinearLayout 

android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android:orientation-"horizontal" 
android:layout marginLeft-"200dip" 
android:layout marginTop-"160dip" 

> 

<ImageButton 

android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:id-"8-«id/minus" B 
android:background-"Gdrawable/btn minus" 
/> 

<ProgressBar 

android: layout_width="250dip" 

android: layout_height="20dip" 
android:paddingLeft="10dip" 
android:paddingRight="10dip" 

android: id="@+id/myprogressbar" 
android:max="100" 

android:progress="100" 
style-"android:attr/progressBarStyleHorizontal" 
/> 

<ImageButton 

android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: id="@+id/plus" Е 
android:background="@drawable/btn_plus" 
/> 

</LinearLayout> 

</LinearLayout> 


// schemas.android.com/apk/res/android" 


这 个 布局 中 定义 了 一 个 进度 条 和 两 个 按钮 ， 设 计 出 来 的 UI 接口 如 图 5-35 所 示 。 


BackLignt Test 


5-35 


" 
RJ 


XUI 
(4) BackLightjava 程 序 代码 编写 


导入 相应 的 包 文件 : 


package com.tw.dmatek.dma210xp.backlight; 
import android.app.Activity; 

import android.os.Bundle; 

import android.view.MotionEvent; 

import android.view.View; 

import android.view.View.OnTouchListener; 
import android.widget.ImageButton; 

import android.widget.ProgressBar; 


让 BackLight_Control 继 承 Activity 实 现 OnTouchListener 方 法 : 


public class BackLight Control extends Activity implements 
OnTouchListener 


定义 变量 : 


private ProgressBar mprogressBar-null; 
private ImageButton mIB minus,mIB plus; 
private int progress-100; 

int fd; 


实现 程序 第 一 次 启动 时 调用 的 方法 onCreate: 


QOverride 
public void onCreate (Bundle savedInstanceState) 
super.onCreate (savedInstanceState) ; 


显示 布局 文件 : 


setContentView (R.layout.main) ; 


调用 布局 文件 中 组 件 的 ID : 


mprogressBar= (ProgressBar) this.findViewById (R.id.myprogressbar); 
mIB minus-(ImageButton) this.findViewById (R.id.minus); 
mIB plus-(ImageButton) this.findViewById(R.id.plus); 


为 组 件 添加 监听 事件 : 


mIB minus.setOnTouchListener (this); 
mIB plus.setOnTouchListener (this); 


调用 SO 库 中 的 本 地 方法 : 


fd = Linuxc.openbacklight ();// 调用 SO 的 openbacklight () 打开 设备 
if (fd <=0) 

{ 

setTitle("open device false!"); 

finish (); 

} 


else 


setTitle("open device seccess!"+fd); 
} 
} 


现实 onTouch 方 法 ， 调 用 相应 的 本 地 方法 实现 背光 的 亮 暗 : 


public boolean onTouch (View v, MotionEvent event) 
{ 

if (v==mIB_minus) 

{ 

if (event .getAction () ==MotionEvent .ACTION_DOWN) 

{ 


mIB minus.setBackgroundResource (R.drawable.btn minus pressed); 


else if(event.getAction()--MotionEvent.ACTION UP) 

{ 

mIB minus.setBackgroundResource (R.drawable.btn minus); 
Linuxc.backlight down();// Ж 

if (progress>0) 

progress--25; 

else 

progress-0; 

} 

} 

else if (v==mIB_plus) 

{ 

if (event .getAction ()==MotionEvent .ACTION_DOWN) 

{ 

mIB plus.setBackgroundResource (R.drawable.btn plus pressed); 
} 


else if(event.getAction()--MotionEvent.ACTION UP) 


mIB plus.setBackgroundResource (R.drawable.btn plus); 
Linuxc.backlight up();// 变 亮 

if (progress<100) 

progress4-25; 

else 

progress-100; 

} 

} 

mprogressBar.setProgress (progress); 
return false; 

} 

} 


(5) 添加 JNI 函 数 本 地 方法 定义 的 Java 程 序 


右 击 项 目 图 标 ， 在 弹出 菜单 中 选择 “New” 一 “Class”， 如 图 5-36 所 示 。 


= i= BackLight Control 


E gh EFC 


ri Project... 


Open in Hew Window 

] ED assets Open Type Hierarchy F4 

HGS res Shoy In ALtHShiftt+H P 
4 „А 


图 5-36 新建 一 个 类 


弹出 如 图 5-37 所 示 界 面 。 填 写 相应 信息 后 ， 点 击 “Finish” 按 钮 完成 。 


编辑 Linuxc 这 个 Java 文 件 。 这 个 类 定义 了 背光 的 本 地 方法 ， 并 调用 SO 库 。 程 序 代码 如 下 所 示 : 


package com.tw.dmatek.dma210xp.backlight; 
import android.util.Log; 

public class Linuxc { 

static { 

try { 

Log.i("JNI", "Trying to load libbacklight.so"); 
/* 调用 libbklight.so Ж */ 

System. loadLibrary ("backlight") ; 

} catch (UnsatisfiedLinkError ule) { 
Log.e("JNI", "WARNING: Could not load libbacklight.so"); 
} 


l 

/* 声明 openbacklight () 为 本 地 方法 */ 

public static native int openbacklight (); 
/* 声明 closebacklight () 为 本 地 方法 */ 

public static native int closebacklight (); 
/* 声明 backlightcontrol () 为 本 地 方法 */ 
public static native void backlight_up(); 
public static native void backlight down(); 
} 


通过 设计 底层 方法 来 实现 对 驱动 的 调用 。 若 已 有 使 用 事先 编译 的 SO 函数 库 及 JNI 函 数 ， 或 使 用 自行 编译 的 动态 链接 库 ， 首 先 将 libs\armeabiNlibbacklight.so 这 个 文件 拷贝 到 项 目 目录 下 ， 如 图 5-38 所 
示 。 请 注意 路 径 必须 维持 为 libs\armeabi\libbacklight.so。 


£ New Java Class 


Java Class 


Create a new Java class. 


Source folder: BackLi ght_Control/sre ] | Browse.. 


Package: ‘com. tw. dmatek. dma210xp. backlight [| Brogse.. 
[ ]Enclosing type: | Browse 
Name: Linuxc| — 


Modifiers: ©) public © default private 
[]abs&ract [ | final static 


Superclass: java. lang. Object | | Browse.. 


Interfaces: + 


Which method stubs would you like to create? 


[ public static void main(String[] args) 
[ Constructors from superclass 
[V| Inherited abstract methods 


Do you want to add comments? (Configure templates and default value here) 
Generate comments 


@) wF 


图 5-37 填写 类 名 


т C:\apk workspaceXBackLight Control\libs\... BEES 
SHG) бї SEW 收藏 和 ) IAW #80) ДЕ 


backlight. so 
0 X 


1 
q 


5-38 添加 SO 函数 库 
(6) 刷新 工程 ， 添 加 编译 出 来 的 SO 中 间 库 文件 


选择 项 目 ， 按 F5 键 刷新 项 目 ， 如 图 5-39 所 示 。 


刷新 后 ， 项 目 中 的 工程 SO 文件 如 图 5-40 所 示 。 


E Тата — Eclipse SDE 
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Help 
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Close Project 


Run As 
Debug As 
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: Android SD Team 


5-39 ”刷新 工程 


£ Java 一 Eclipse SDE 


File Edit Кип Havigzate Search Project Refactor Window 
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8-08 ger [Generated Java Files] 
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(7) 生成 APK 


由 于 Eclipse 可 以 设 定 自动 编译 功能 ， 因 此 当 把 SO 复制 到 工程 目录 下 时 ， 它 也 已 经 编译 完成 了 。 生 成 的 APK 在 项 目 目录 的 bin 目 录 下 。 如 图 


图 


5-40 查看 工程 中 SO 


5-41 所 示 。 


fS C:\apk_workspace\RackLight_Control\bin 
THEO AmO B60 Uma ТАТ ЖШН) 
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resources. ap - 
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图 5-41 生成 的 APK 


到 此 ， 背 光 测 试 实验 设计 完成 了 。 
2. 背 光 JNI 设 计 
(1) 背光 的 SO 的 编写 
将 BackLight_Control 工 程 拷 贝 到 读者 的 工作 目录 下 ， 工 作 目 录 C:\apk_workspace\BackLight_Control。 
(2) 编译 Java 文 件 成 C 语 言 的 头 文件 


1) 在 “开始 ”菜单 中 点 击 “ 运 行 ”， 然 后 输入 “cmd” 进 入 DOS 命 令 提示 符 窗口 ， 如 图 5-42 所 示 。 


en AR. E XH Internet WRAS 


5-42 启动 DOS 


2) 进入 Ci\apk_workspace\BackLight_Control 目 录 下 ， 如 图 5-43 所 示 。 


icrosoft Windows XP the 5.1.26081 
<C> 版 权 亲 有 1985-2881 Microsoft Corp. 


>: Documents and Settings VMidninistrator»cd C:'*apk workspace'*BackLight Control 


`. 


: vapj_workspaceNBackLight_contro1>。 


5-43 ”进入 BackLight_Control 工 程 目录 


3) 建立 一 个 名 称 为 jni 的 目录 ， 然 后 进入 jni 目 录 。 如 图 5-44 所 示 。 


С: \apk_workspace \BackLight_Control>md jni 
C: \apk_workspace\BackLight_Control>cd jni 


C: sAapk workspace MBackLight  Control*jni», 


5-44 #BackLight_Control L4 E) RP €] #Ëjni A Ж 


jni 目 录用 于 存放 C 及 C+ + 原始 程序 代码 文件 ， 以 及 要 编译 这 些 程序 代码 的 脚本 文件 。 


4) 执行 命令 “javah-classpath “C:\apk_workspace\Backlight_Control\bin”com.tw.dmatek.dma210xp.backlight.Linuxc”。 如 图 5-45 所 示 。 在 当前 目录 jni 下 生成 一 个 
com tw_dmatek_dma210xp_backlight_Linuxc.h 文 件 。 


sx C:\FINDOFS\system3?2\cad. exe 


>: арк _ workspace“\BackLight Control\jniS?javah -classpath “C:\apk_workspace \Backli 
tht Control*bin" соп. ём. бтаёе К. дпа21Ихр. ЉаскіічћпЕ .Linuxc 


5: apk_works pace sBackLight, GControl*jni»dir 


ahes C Haass SYSTEM 
Amm ES 982С-75ӨВ 


C:sapk workspace \BackLight_Control\jni BJ B 


1011-16-14 89:68 <DIR> 

1411-14-14 49:88 <DIR> “fe 

7011-10-14 89-88 1,222 com tu dnatek dma218xp backlight Linuxc.h 
p 1.222 ЖТ 


图 5-45 生成 头 文件 


(3) 创建 bk_light.h 头 文件 


#ifndef BL DRV H 
#define BL DRV H 
#define BK LIGHT UP 1 
#tdefine BK LIGHT DOWN 0 
#define BK LIGHT SET 3 
fendif Е a 


(4) 编写 调用 C+ + 语言 头 文件 的 C 程 序 代码 


C 程 序 代码 创建 一 个 com_tw dmatek dma210xp_backlight_Linuxc.c 文 件 ， 实 现 com_tw_dmatek_dma210xp_backlight_Linuxc.h 这 个 头 文件 中 定义 的 函数 ， 其 程序 代码 如 下 : 


定义 相应 的 头 文件 : 


#include <stdio.h> 

#include <stdlib.h> // system 

finclude <fcntl.h> 

#include <errno.h> 

#include <unistd.h> 

#include <sys/ioctl.h> 

#include "bk_light.h" 

*include "com tw dmatek dma210xp backlight Linuxc.h" 


定义 相应 的 宏 : 


#define DEVICE BLTEST "/dev/backlight" // 设备 节点 


定义 变量 : 


int fd; 


实现 本 地 方法 openbacklight: 


JNIEXPORT jint JNICALL 
Java_com_tw_dmatek_dma210xp_backlight_Linuxc_openbacklight (JNIEnv *p, jclass c) 
{ 

fd= open (DEVICE_BLTEST, O_RDONLY) ; // 打开 设备 

if (fd<0) 

{ 

return 0; 

} 

return fd; 

i 


实现 本 地 方法 closebacklight: 


JNIEXPORT jint JNICALL 
Java_com_tw_dmatek_dma210xp_backlight_Linuxc_closebacklight (JNIEnv*p, jclass c) 


{ 
close (Ёа); 
$ 


实现 本 地 方法 backlight up: 


JNIEXPORT void JNICALL 
Java_com_tw_dmatek_dma210xp_backlight_Linuxc_backlight_up(JNIEnv*p, jclass c) 


{ 
ioctl (fd, BK_LIGHT_UP, NULL) ; 
} 


实现 本 地 方法 backlight_down: 


JNIEXPORT void JNICALL 
Java_com_tw_dmatek_dma210xp_bac klight_Linuxc_backlight_down(JNIEnv *p, jclass c) 


{ 
ioctl (fd, BK_LIGHT_DOWN, NULL) ; 
} 


(5) 创建 生成 SO 的 配置 文件 


现在 jni 目 录 下 已 经 有 com _tw_dmatek_dma210xp_backlight_Linuxc.c、com tw _dmatek_dma210xp_backlight_Linuxc.h 和 bk_light.h 这 三 个 文件 。 还 需要 添加 一 个 脚本 文件 实现 编译 链接 ， 其 文件 
名 为 Android.mk， 其 代码 如 下 : 


LOCAL_PATH := $(call my-dir) 

include $ (CLEAR VARS) 

LOCAL MODULE := backlight 

LOCAL SRC FILES := com tw dmatek dma210xp backlight Linuxc.c 
include $(BUILD SHARED LIBRARY) ~ = Е 


(6) 生成 SO 动态 链接 库 


打开 Cygwin 终 端 ， 进 入 Ci\apk_workspace\BackLight_Control 目 录 ， 然 后 执行 “ndk-build” 命 令 即 可 。 如 图 5-46 所 示 ， 生 成 需要 的 动态 链接 库 5O。 


= /cygdrive/c/apk workspace/BackLight Control 


cd apk workspace^ 


cd BackLight_Control/ 


ndk-hui1d 


ompilc thumb backlight 《~ con tu dnatck dmo21B8xp backlight Linuxc.c 
s«haredLihrary libhacklight.so 


Install libbacklight.so -> libs^armcabi/lihbacklight.so 


5-46 ”生成 动态 链接 库 


Të 


测试 自己 编写 的 背光 控制 程序 ， 步 又 如 下 : 


Т) 打开 DMA-210XP 平 台 的 电源 ， 启 动 系统 。 


2) 添加 backlight 驱 动 ， 在 串 行 口 工具 中 输入 如 下 命令 : 


#са sdcard 
fcd backlight 
# pwd 

/sdcard/backlight 

# insmod bk_light.ko 

Backlight driver register success! 

# busybox mknod /dev/backlight c 238 0 


3) 安装 好 应 用 程序 。 


4) 测试 。 


点 击 BackLight 控 制 应 用 程序 ， 如 图 5-47 所 示 。 


D | йо ms 


BackLight Test 


图 5-47 ”背光 灯 操 作 接口 


通过 点 击 “ 减 小 ”按钮 ， 观 察 DMA-210XP 平 台 的 屏幕 的 亮 暗 ， 点 击 “ 增 加 ”按钮 是 否 变 亮 ， 这 样 来 测试 程序 是 否 正确 。 


10 位 或 12 位 CMOS 的 ADC ( 模 数 转换 器 ) 是 有 10 通 道 模拟 输入 的 循环 类 型 设备 。 其 转换 模拟 输入 信号 到 10 位 或 12 位 的 数字 编码 ， 最 大 的 转换 率 是 在 5M Hz 转换 时 钟 下 达到 1MSPS。AD 转 换 器 支持 片上 
采样 和 保持 功能 及 掉 电 模式 。 


触摸 屏 接 口 可 以 控制 或 选择 触摸 屏 触 点 用 于 XY 坐标 的 转换 。 触 摸 屏 接口 包括 触摸 触 点 控制 逻辑 和 有 中 断 产生 人 逻辑 的 ADC 接 口 逻 辑 。 


ADC 及 触摸 屏 接 


的 主要 特性 如 下 : 


AERE: 10 位 /12 位 (可 选 ) o 


- 微分 线性 误差 : 1.0 LSB (RAK) o 


积分 线性 误差 : 4.0 LSB (RK) o 


- 最 大 转换 速率 : 1 MSPS. 


WA Ho 


“供电 电压 : 3.3V。 


` 输入 模拟 电压 范围 : 0~3.3V。 


“ 片上 采样 保持 功能 。 


“ 普通 转换 模式 。 


:分离 的 XY 坐 标 转换 模式 。 


“ 自动 连续 XY 坐标 转换 模式 。 


.等待 中 断 模式 。 


- IDLE、DIDLE、STOP 和 DSTOP 模 式 唤醒 源 。 


+ 两 个 触摸 屏 接口 。 


到 5-48 显 示 了 ADC 和 触摸 屏 接 口 的 功能 结构 框图 。ADC 的 装置 是 一 个 循环 的 类 型 。 


PINI_IEPO 1 
XM_SENO, 1 
YM_SENO, 1 
XP SEND, 1 
YP. SEND, 1 


Touch screen 
pads control 


AINS(XPO), AINS(XP 1) Í 


AINA(XMO), AIN&(XM1) | 


АІМЗ(ҮРО), AIN7(YP1) [ 


AIN2(YM0). AIN6(YM1) 


INT_ADCO 
INT_PENO 


AIN1, AINO [ 
Interrupt 


ADU input generation INT ADC1 
control INT PEN1 


Waiting for interrupt 


图 5-48 ADC 和 触摸 屏 接 口 的 功能 结构 框图 


当 使 用 触摸 屏 装 置 时 ， 触 摸 屏 的 |//F、XM 或 YM 只 接地 。 当 未 使 用 触摸 屏 的 装置 时 ， 为 正常 ADC 转 换 ，XM 或 YM 是 连接 模拟 输入 信号 的 。 


2. 功 能 描述 
(1) A/D 转 换 时 间 
当 PCLK 频 率 为 66MHz 和 预 分 频 器 (预定 标 器 ) 值 为 65，12 位 A/D 转 换 器 转换 时 间 如 下 : 
.A/D 转换 器 频率 =66MHz/ (65+1) =1MHz 
- 转换 时 间 =1/ (1MHz/5cycles) =1/200kHz=5ps 
注意 : AD 转换 器 设计 在 最 大 5MHz 时 钟 下 工作 ， 所 以 转换 率 最 高 达到 1MSPS。 


(2) 触摸 屏 接口 方式 


1) 正常 转换 模式 (AUTO_PST=0, XY_PST=0) 


这 种 模式 下 的 操作 与 AIN0~AIN9 类 似 。 初 始 化 这 个 模式 ， 要 设置 T SADCCON0 的 (ADC 控制 寄存 器 ) 和 TSCONn (触摸 屏 控制 寄存 器 ) 。 上 拉 电 阻 和 开关 应 关闭 (如 果 TSCON0 和 TSCONT1 被 设置 为 
0x58， 所 有 开关 是 关闭 的 ) 。 转 换 后 的 数据 可 以 从 TSDATX0 (ADC 转 换 数 据 寄存 器 X) 读 出 。 


2) 分 离 XY 坐 标 转换 模式 (AUTO_PST=0, XY_PST=control) 
触摸 屏 控制 器 可 以 在 以 下 两 种 转换 模式 中 的 一 种 模式 下 操作 。 
X 位 置 测定 的 方法 步 又: 

"TSCONn 设 置 为 0x69。 

* (XY PST-1, AUTO_PST=0, PULL UPA3k, XPH Ж, XM 有效 ，YP 失 效 ， YM 失效 ) 
+ 设置 TSADCCONn 开 始 转换 。 

+ X 位 置 转换 结束 可 以 产生 中 断 CINT_ADCn) 。 

< 从 TSDATXn 读 取 转 换 数 据 (X 位 置 ) 。 

Y 位 置 测定 的 方法 步骤 : 

"TSCONn 设 置 为 0x9a。 

* (XY PST-2, AUTO PST-0, PULL UPAX3t, ХРЖЖ, XM X3k, YPA 2, YMA HK) 。 
+ 设置 TSADCCONn 开 始 转换 。 

б Y 位 置 转换 结束 可 以 产生 中 断 (INT_ADCn) 。 

< 从 TSDATYn 读 取 转 换 数 据 (Y 位 置 ) 。 

3) 自动 (连续 ) XY 坐标 转换 模式 (AUTO PST-1, XY_PST=0) 

自动 (连续 ) XY 坐标 转换 模式 的 操作 步骤 : 

“设置 TSCONn 为 0x5c。 


* (XY_PST=0，AUTO_PST=1，PULL_UP 失 效 ，XP 失 效 ，XM 失 效 ，YP 失 效 ，YM 失 效 ) 


+ 设置 TSADCCONn 开 始 转换 。 

“ 触摸 屏 控制 器 转换 X 位 置 并 写 入 TSDATXn。 

+ 触摸 屏 控制 器 转换 Y 位 置 并 写 入 TSDATYn。 

+ 触摸 屏 接口 产生 中 断 (INT_ADCn) ， 换 各 话说 ，CINT_ADCn 中 断 只 有 一 次 而 不 是 两 次 。 


4) 等 待 中 断 模式 (TSCONn[7: 0]=0xd3) 


当 光 标 按 下 或 抬 起 ， 触 摸 屏 控制 器 产生 中 断 信 号 (INT_PENn) 。TSCONn[7: 0] 必 须 为 0xd3， 此 时 Pul-up 有 效 ，XP 失 效 ，XM 失 效 ，YP 失 效 和 YM 有 效 。 触 摸 屏 控制 器 产生 中 断 信号 (INT PENn) 
后 ， 等 待 清除 中 断 模式 (ХҮ Р5Т=0) 。 


(3) 备用 模式 


当 TSADCCON0 寡 存 器 的 TSSEL=0 和 STANDBY=1 时 ， 备 用 模式 可 以 使 用 。 这 种 模式 下 ，A/D 转 换 操作 停止 ，TSDATXn 和 TSDATYn 寄 存 器 锁 住 其 寄存 器 中 的 数据 。 


(4) 双 触 摸 屏 接 | 


两 组 触摸 屏 接口 分 别 为 AIN[5]~AlIN[2] 的 触摸 屏 0 和 AIN[9]~AlN[6] 的 触摸 屏 1。 对 于 两 个 触摸 屏 的 XP 和 XM ，YP 和 YM 控 制 等 由 分 离 的 开关 进行 控制 。 它 们 共享 一 个 模拟 信号 转换 ， 因 此 两 个 触摸 屏 的 接 
口 采用 轮转 方式 。TSADCCON0 寡 存 器 的 TSSEL 位 用 于 选择 连接 到 ADC 的 触摸 屏 。 因 此 ， 在 访问 TSADCCON1 之 前 ， 必 须 设 置 1 到 TSSEL。 同 样 ， 在 访问 TSADCCON0 之 前 ， 必 须 设置 0 到 TSSEL。 


当 TSSEL 位 为 0 时 ， 禁 止 访问 TSADCCON1 位 。 当 TSSEL 位 为 1 时 ，TSADCCON0 中 除了 TSSEL 位 也 被 禁止 。 始 终 允 许 访问 TSSEL 位 。 


3.ADC 及 触摸 屏 专用 寄存 器 


ADC 和 触摸 屏 专用 寄存 器 如 表 5-25~ 表 5-31 所 示 。 


(1) ADC 的 控制 寄存 器 (TSADCCONn) 
- TSADCCONO, R/W, Address=0xE170_0000 


- TSADCCON1, R/W, Address=0xE170_1000 


表 5-25 ADC 控 制 寄 存 器 


TSADCCONn 
触摸 屏 选 择 
0= 触摸屏 0(AIN2 ~ AINS ) 
1 = 触摸屏 1 (AIN6 ~ AIN9 ) 
只 存在 TSADCCON0 中 
注意 : “4 TSSEL 位 为 0 时 ， 禁 止 访 问 TSADCCONI 位 。 当 TSSEL 位 为 
1 F, TSADCCONO 中 除了 TSSEL 位 也 被 禁止 。 始 终 人 允许 访 问 TSSEL 位 

ADC 长 度 选择 
0 — 10 fj A/D 转换 
1 = 12 fii A/D 转换 
转换 的 结束 标记 (只 读 ) 
0= A/D 转换 过 程 中 
1= A/D 转换 结束 
ADC 预定 标 絮 启动 

PRSCEN 0= 禁 用 0 
1= 启动 
A/D 转换 预 分 频 器 值 
数据 值 : 5 ~ 255 


PRSCVL 
分 频 因 子 (N+1) 时 ， 预 分 频 值 是 N 


OxFF 


例如 ，ADC 频率 为 3.3MHz， 如 果 PCLK 为 66MHz 和 预 分 频 值 是 19 


TSADCCONn 


Reserved 

待机 模式 选择 
STDBM 0= 正常 运作 模式 

1 = 待机 模式 

A/D 转换 开始 读 取 
READ START 0= 禁 用 开始 读 操作 


1 = 启动 开始 读 操作 

A/D 转换 开始 启用 

AA READ START 启用 ， 这 个 值 是 无 效 的 
0= 无 行动 

1 =A/D 转换 开始 和 该 位 被 清理 后 开启 


ENABLE START 


(2) 触摸 屏 控制 寄存 器 (TSCONn) 
+ TSCONO, R/W, Address=0xE170_0004 
+ TSCON1, R/W, Address=0xE170_1004 
表 5-26 触摸屏 控 制 寄存 器 
TSCONn 初始 状态 


检测 触摸 笔 向 上 向 下 的 位 置 
0 一 触摸 笔 向 下 中 断 信号 


YM 开关 启动 
YM_SEN [7] 0=YM 输出 驱动 器 禁用 0 


1 =YM 输出 驱动 器 启动 


YP 开关 启动 
YP_SEN [6] 0 =YP 输出 驱动 器 禁用 1 
1 =YP 输出 驱动 器 启动 
XM 开关 启动 
XM SEN [5] 0 =XM 输出 驱动 器 禁用 
1 =XM 输出 驱动 器 启动 
XP 开关 启动 
XP SEN [4] 0 —XP 输出 驱动 器 禁用 1 
1 =XP 输出 驱动 器 启动 
上 拉 开 关 启 动 
PULL UP [3] 0 =XP 上 拉 开 关 启 用 1 
1 =XP 上 拉 开 关 禁 用 


X 和 Y 的 位 置 的 自动 定 序 转换 

AUTO PST [2] 0 = 正常 的 ADC 转换 0 
1 =X 和 YY 的 位 置 的 自动 定 序 测量 
X 和 YY 坐标 的 手动 测量 


© 


00 = 没有 运作 模式 

XY PST [1:0] 01 = X 坐标 测量 0 
10 = Y 坐标 测量 
11 = RE Pst 


(3) АСЕНА SFRS (TSDLYn) 
- TSDLYO, R/W, Address=0xE170_0008 
: TSDLY1, R/W, Address=0xE170_1008 


表 5-27 ADCAEGR d £3 


TSDLYn 


FILCLKsre 


(4) ADC 转 换 数据 X 寄 存 器 (TSDATXn) 
+ TSDATXO, R, Address=0xE170_000C 


* TSDATX1, R, Address=0xE170_100C 


TSDATXn 


UPDOWN 


AUTO_PST_VAL 


XY_PST_VAL 


XPDATA 


(5) ADC 转 换 数据 Y 寄 存 器 (TSDATYn) 
.TSDATY0，R，Address=0xE170_0010 


* TSDATY1, R, Address=0xE170_1010 


ADCDLY 时 钟 初始 化 

0= 外 部 输入 时 钟 

1 =RTC 时 钟 

TE ADC 转换 模式 中 (正常 、 独 立 自动 转换 )， 
ADC 转换 要 为 其 计算 数值 延迟 。 
例如 等 待 中 断 模式 : 


在 等 待 中 断 模式 中 触 针 按 下 ， 将 在 间隔 的 几 个 ms 中 产生 重大 信号 
(INT_PENn)。 如 果 中 断 发 生 在 STOP 模式 下 ， 由 于 需要 退出 STOP 
模式 ,会 在 一 段 间 隔 ( 几 个 ms) 后 产生 唤醒 信和 号 

注意 : 不 应 使 用 0 值 (0x0000 ) 


[13:12] 


EN 


表 5-28 ”ADC 转换 数据 X 寄 存 器 


等 待 中 断 模式 下 触 针 的 抬 起 或 按 下 状态 

0= 光标 按 下 

1 = 光标 抬 起 

УЙШ TSCONn 寄存 器 中 AUTO PST 的 值 。 只 读 
0= 普 通 ADC 转换 

1=X 坐 标 和 Y 坐标 连续 测量 


测定 TSCONn 寄存 器 XY PST 的 值 。 只 读 

00 = 无 操作 模式 

01 = X 坐标 测定 

10 =Y 坐标 测定 

11 = 等 竺 中断 模式 

X 坐标 的 数据 转换 (包括 正常 的 ADC 的 转换 数据 值 ) 
数据 值 : 0х0 ~ Oxfff 


表 5-29 ”ADC 转换 数据 Y 寄 存 器 


初始 状态 


TSDATYn 


UPDOWN 


AUTO PST VAL 


XY PST VAL 


YPDATA 


(6) ADC 中 断 清 除 寄存 器 (CLRINTADCn) 
“ CLRINTADCO, W, Address=0xE170_0018 


+ CLRINTADCI, W, Address=0xE170_1018 


这 些 寄存 器 用 于 清除 中 断 。 中 断 服务 完成 后 中 断 服 务 程序 负责 清除 中 断 。 


初始 状态 
等 待 中 断 模式 下 触 针 的 抬 起 或 按 下 状态 

0= 光标 按 下 x 

1 = 光标 抬 起 

检测 TSCONn 寄存 器 中 AUTO PST fff. Ri 


0= 普 通 ADC 转换 == 


1=X 坐 标 和 Y 坐标 连续 测量 


测定 TSCONn 寄存 器 XY PST 的 值 。 只 读 

00 = 无 操作 模式 

01 = X 坐标 测定 = 
10 = Y 坐标 测定 

11 = 等 待 中 断 模式 

Y 坐标 的 转换 数据 

数据 值 : 0x0 ~ OxFFF 


该 寄存 器 中 的 值 将 随 着 新 中 断 发 生 被 清除 。 若 此 时 被 读 入 将 返回 不 确定 的 值 。 


表 5-30 ADC 中 断 清除 寄存 器 


ADCMUX 


SEL MUX 


54.2 ADC 接 口 电路 


复位 值 
模拟 输入 通道 选择 

0000 = AIN 0 

0001 = АТМ 1 

0010 = AIN 2 (YMO) 

0011 = AIN 3 (YPO ) 

0100 = AIN 4 (XM0) = 
0101 =AIN 5 (ХРО) 

0110=AIN 6 (ҮМІ) 

0111 =AIN7 (YP1) 

1000 = AIN 8 (XMI ) 

1001 = AIN 9 (XP1 ) 


S5PV210 有 两 组 touch 接 口 : 其 中 AIN[5]~AIN[2] 提 供给 触 屏 0，AIN[9]~AIN[6] 提 供给 触 屏 1， 它 们 分 别 有 独 立 的 开关 控制 XP、XM、YP 和 YM ， 以 及 独立 的 寄存 器 。 它 们 共享 一 个 AD 转换 器 ， 因 此 两 


套 屏 的 接口 需要 轮流 使 用 。 寄 存 器 TSADCCON0 的 TSSEL 位 用 来 选择 哪个 触摸 


屏 连 接 ADC， 如 果 想 使 用 TSADCCON0 就 需要 把 TSSEL 设 为 0。S5PV210 内 部 AD 与 触摸 屏 外 部 接口 如 图 5-49 所 示 。 


XadcAINO 
XadcAIN1 . XadcAIN 0 


XadcAIN 1 
XadcAIN2 a 
XadcAIN3 . XadcAIN 2 


XadcAIN4 


XadcAIN 3 TouchScreen 
XadcAIN_4 ADC 
XadcAINS - 


v XadcAIN 6 
一 一 一 E XadcAIN 7 


XadcAIN 8 
Xen ANZ | XadcAIN_9 


图 5-49 ADC 与 触摸 屏 外 部 接口 


543 ”ADC 驱动 程序 设计 


建立 工程 后 ， 首 先 考虑 UI 设 计 ， 在 画面 上 设计 5 个 按钮 (4 个 open，1 个 Exit) ，12 个 TextView 用 来 显示 信息 ， 以 及 一 个 自 定义 的 View， 用 来 显示 改变 ADC 值 时 的 波形 图 ， 如 图 5-50 所 示 。 


图 5-50 ADC 转 换 界面 图 


1. 新 建 工程 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 图 5-51 所 示 菜 单 。 


2) 在 弹出 菜单 中 选择 New->Project， 如 图 5-52 所 示 。 


弹出 如 图 5-53 所 示 的 窗口 。 


New 


Show In AlttShiftty > 


EB Copy CtrltC 
F= Copy Qualified Name 
Faste CtrltV 


Ж Delete Delete 


гуч Import... 
gy Export... 


| de Refresh 


5-51 ж %Раскаре Explorer ó Ab. 


ALttShiftt | F Example.. 


Ctrl+C F5 Other... 


= Copy Qualified Name 
[B Paste CtrltV 
36 Delete Delete 


H5-52 HEL 


-g Java Project 
$ Java Project from Existing Ant Buildfile 


2 Plug-in Project 
(Ж General 
(> Android 
Ч Android Test Project 
Android XML File 


H 


8 (E CVS 
@-@ Java 


由 (Ж Plug-in Development 
H-E User Assistance 


图 5-53 新建 工程 窗口 


3) 选择 Android->Android Project， 点 击 Next 按 钮 ， 在 相应 位 置 填 入 信息 。 点 击 Finish 按 钮 完成 创建 。 


2. 编 辑 layout/adc.xml， 进 行 UI 设 计 


layoutadc.xml 文 件 的 程序 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http:// schemas.android.com/apk/res/android" 
android: id="@+id/widget0" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" = 
«tw.com.dmatek.dmas5pv210.adc.DrawView 
android: id="@+id/drawview" 
android: layout_width="fill parent" 
android:layout height-"fill parent" j> 
<TextView 
android:id="@+id/big" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="3.3" 
android:layout_marginLeft="15px" 


android:layout_marginTop="70px" /> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/...// 省 略 部 分 内 容 
<Button 


android: id="@+id/adc_mButton1" 
android: layout_width="80px" 
android:layout height-"wrap content" 
android:text-"open" 
android:textSize-"20sp" 
android:layout marginTop-"70px" 
android:layout alignParentRight-"true" /> 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...// 省 略 部 分 内 容 
<TextView 
android: id="@+id/adc_channel1" 
android: layout_width="40px" 
android:layout height-"wrap content" 
android: layout_toLeftOf="@+id/adc_mButton1" 
android: layout_alignBaseline="@+id/adc_mButton1" /> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/...// 省 略 部 分 内 容 
</RelativeLayout> 


在 上 述 代码 中 ，android:id 定 义 Button 和 TextView 的 id。android:layout_ width 和 android:layout_height 定 义 组 件 的 宽 | 
动 调整 其 大 小 )。android:textSize 定 义 了 android:text 字 体 的 大 小 。android:layout_alignBaseline 和 android: 
tw.com.dmatek.dmas5pv210.adc.DrawView 为 自 定义 的 控件 ， 通 过 DrawView.java 来 实现 自 定 义 的 控件 ， 上 


3. 编 写 Adc_Control.Java 程 序 代码 


Ий] 


+ 
+ 


+ 


标 ， 在 弹出 菜单 中 选择 New 一 >Class， 如 图 5-54 所 示 。 


波形 


图 来 显示 ADC 值 的 变化 。 


度 和 高 度 ， 高 度 为 wrap_content(wrap_content， 表 示 根 据 当前 View 的 内 容 
ayout roRightOf 等 都 是 相对 布局 的 定位 方式 ， 例 如 ， 各 个 边 对 齐 、 


ES gen [Ge 
mA Android Open in New Window 
G^ assets 


e res Show In 


Üpen Type Hierarchy 


22] 


5-54 新 建 一 个 类 


F4 
AlttShifttW P 


在 Name 一 栏 填 入 “Adc_Control”， 然 后 点 击 Finish 按 钮 完成 创建 Adc_Controljava 文 件 的 操作 。 由 于 程序 代码 过 长 ， 这 里 只 选择 部 分 程序 代码 。 


居中 对 齐 等 。 


class RefreshHandler extends Handler 
{ DrawView _draw; 

public RefreshHandler (DrawView draw) 
_draw=draw; 


{ 
) 


@Override 
public void handleMessage (Message msg) 
{ if (msg.what==1) 


) 
} 


{ 
} 


process drawview(); 
. draw. invalidate (); 


class myThread implements Runnable 
{ public void run() 
{ while (!Thread.currentThread() .isInterrupted () ) 


{ 


Message message = new Message () ; 
message.what = 1; 
Adc Control.this.myHandler.sendMessage (message) ; 
try { Thread.sleep (100) ; 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace () ; 


在 主 程序 中 ， 通 过 建立 一 个 线程 来 持续 检测 ADC 值 的 变化 ， 但 是 线程 中 不 能 更 新 控件 ， 可 以 使 


Handler 读 取 一 次 invalidate() 函 式 ， 用 来 重新 绘制 自 定义 控件 DrawView， 利 用 线程 来 更 新 控件 ， 以 便于 更 新 波形 | 


4.DrawView 主 要 程序 代码 


建立 DrawView.java 文 件 ，DrawView 主 要 程序 代码 如 下 : 


用 读 取 Handler 来 更 新 自 定义 的 控件 。 启 用 线程 后 ， 每 隔 100 毫 秒 向 Handler 对 象 传递 一 次 消息 ， 然 后 


public class DrawView extends View 

private Rect rect=new Rect (); 

public DrawView (Context context) 

super (context) ; 

// TODO Auto-generated constructor stub 


{ 
{ 
} 


public DrawView(Context context, AttributeSet attrs) 
super (context, attrs); 
// TODO Auto-generated constructor stub 


{ 
] 


public DrawView (Context context, AttributeSet attrs, int defStyle) 
super (context, attrs, defStyle); 
// TODO Auto-generated constructor stub 


{ 
] 


GOverride 

protected void onDraw(Canvas canvas) 

final Paint pa-new Paint(); 

pa.setColor (Color.WHITE); 

rect.set(50, 70, 600, 400); 
canvas.drawRect (rect, pa); 

pa.setColor (Color.GRAY); 
canvas.drawLine(50, 100, 600, 100, pa); 
canvas.drawLine(50, 200, 600, 200, pa); 
canvas.drawLine(50, 300, 600, 300, pa); 
pa.setColor (Color. YELLOW) ; 
pa.setStrokeWidth (4) ; 

for(int i=0;i<Config.num1-1;i++) 

canvas .drawLine (Config.X[i],Config.Y[i], Config.X[i*1], Config.Y[i+1], pa); 
pa.setColor (Color.RED) ; 
pa.setStrokeWidth (4) ; 

for(int j=0;j<Config.num2-1; j++) 

canvas .drawLine (Config.X[j],Config.chanel2[j], Config.X[j*1], Config.chanel2[j41], pa); 
pa.setColor (Color.GREEN) ; 
pa.setStrokeWidth (4) ; 

for(int k=0;k<Config.num3-1; k++) 


{ 


canvas .drawLine (Config.X[k], Config.chanel3[k], Config.X[k*1], Config. 


chanel3[k+1], pa); 

pa.setColor (Color.BLUE) ; 
pa.setStrokeWidth (4) ; 

for(int 1=0;1<Config.num4-1;1++) 


canvas.drawLine (Config.X[1], Config.chanel4[1], Config.X[1+1], Config. 


chanel4[1+1], pa); 


} 
} 


个 函 式 来 实现 自 定义 控件 。 其 中 : 


í 


在 上 述 代码 中 ，DrawView 继 承 自 View， 这 样 DrawView 继 承 了 View 的 所 有 的 性 质 。 要 实现 新 的 构造 函 式 ， 以 及 重 写 onDraw() 函 式 ， 上 


canvas.drawLine (50, 100, 600, 100, pa); 
canvas.drawLine(50, 200, 600, 200, pa); 
canvas.drawLine (50, 300, 600, 300, pa); 


来 画 三 条 灰色 直线 ， 用 于 标记 ADC 的 电压 值 ， 三 条 直线 分 别 代表 1V、2V 和 3V。 从 4 个 for 循 环 中 读 取 drawLine 函 式 用 来 画 线 ， 不 断 地 更 新 ， 进 而 显示 ADC 变 化 的 波形 图 。 


5.Linuxc.java 程 序 代 码 


建立 Linuxcjava 文 件 ，Linuxc.java 程 序 代码 如 下 : 


package tw.com.dmatek.dmas5pv210.adc; 
import android.util.Log; 
public class Linuxc ( 
static ( 
try 0 
Log.i("JNI", "Trying to load libadc.so"); 
/* iklRlibadc.sos AR */ 
System. loadLibrary ("adc"); 
) catch (UnsatisfiedLinkError ule) ( 
Log.e("JNI", "WARNING: Could not load libadc.so"); 
} 
} 
public static native int openadc(); 
public static native float adcsend(int channel); 
public static native int closeadc(); 


在 上 述 代码 中 ， 定 义 了 与 底层 通信 的 接口 函 式 ，openadc0 用 于 打开 ADC 设 备 ，closeadc() 用 于 关闭 打开 的 ADC 设 备 ，adcsend(int channel) 表 明 读 取 哪 个 ADC 设 备 的 值 。 


6. 生 成 SO 函 式 库 


依据 Linuxcjava 文 件 ， 执 行 jdk 中 javah 指 令 来 生成 tw_com_dmatek dmas5pv210 adc_Linuxc.h， 接 着 必须 依据 tw_com_dmatek_dmas5pv210_adc _Linuxc.h 文 件 的 定义 来 建立 相对 的 程序 ， 并 储存 


tw com dmatek dmas5pv210 adc_Linuxc.c 文 件 。 


7. 配 置 Application.mk 


编写 完 后 ， 对 此 NDK 项 目的 相关 文件 Android.mk 和 Application.mk 进 行 配置 ， 配 置 完成 后 进行 编译 ， 执 行 指令 : make APP=adc， 编 译 完成 后 在 \projectNlibs\armeabi 下 生成 SO 文件 ， 将 生成 的 SO 
文件 复制 到 Eclipse 项 目 目录 \libsarmeabi 下 即 可 。 


544 ADC 程序 测试 


通道 ADC0、ADC1、ADC2、ADC3， 分 别 对 应 实验 平台 上 的 ADC0、ADC1、ADC2、ADC3。 点 击 “open” 按 钮 打开 相应 信道 ， 按 钮 上 的 值 变 为 “close” ， 可 以 看 到 采集 的 数据 显示 在 屏幕 上 ， 旋 转 
相应 按钮 ， 其 对 应 的 数据 就 会 相应 更 改 ， 并 在 左 侧 的 大 框 中 以 波形 图 的 形式 显示 ADC 的 值 ， 如 图 5-55 所 示 。 


open device success! 


95-55 ADC 采 集 数 据 显示 界面 


其 中 黄色 线 显示 的 是 ADC0 对 应 的 值 ， 红 色 线 显示 的 是 ADC1 对 应 的 值 ， 绿 色 的 线 显示 的 是 ADC2 的 值 ， 蓝 色 的 线 显示 的 是 ADC3 的 值 。 当 点 击 “Exit” 按 钮 时 ， 退 出 此 测试 程序 。 


5.5 ”键盘 接口 及 驱动 程序 


5.5.1 ”键盘 扫描 原理 


1 .矩阵 键盘 扫描 原理 


与 独立 式 键盘 相 比 ， 要 节省 很 多 的 MO 接口 。 


和 矩阵 式 键盘 一 般 适 用 于 按键 数量 较 多 的 场合 ， 它 由 行 线 和 列 线 组 成 ， 按 键 位 于 行 、 列 的 交叉 点 上 。 一 个 5x 5 的 行列 结构 可 以 构成 一 个 有 25 个 按键 的 键盘 。 很 明显 ， 在 按键 数量 较 多 的 场合 ， 和 矩阵 式 键盘 


按键 设置 在 行 、 列 交叉 点 上 ， 行 、 列 分 别 连 接 到 在 按键 开关 的 两 端 。 一 般 行 线 会 通过 上 拉 电 阻 连 接 到 3V 电 源 上 。 当 无 键 按 下 时 ， 列 线 处 于 低 电 位 状态 ; 当 有 键 按 下 时 ， 相 应 行 线 和 列 线 被 连接 在 一 起 ， 


并 且 置 行 线 电位 为 低 ， 同 时 产生 一 个 按键 中 断 ; 相应 的 CPU 会 写 一 个 低 电 位 给 该 列 线 ， 而 其 他 列 线 被 置 高 写 入 KEYIFCOL 缓 存 器 。 在 每 次 写 的 时 间 内 ，CPU 都 会 读 取 KEYIFROW 缓 存 器 的 值 ， 同 时 判断 列 线 
是 否 有 对 应 的 按键 被 按 下 。 这 一 点 是 识别 矩阵 键盘 是 否 被 按 下 的 关键 所 在 。 因 按键 之 间 相 互 影响 ， 所 以 必须 将 行 线 、 列 线 信号 配合 起 来 并 做 适当 的 处 理 ， 才 能 确定 闭合 键 的 位 置 。 


根据 上 面 的 描述 ， 很 容易 得 出 按键 的 识别 方法 ， 分 为 下 列 的 几 步 : 


1) 识别 键盘 的 哪 一 行 被 按 下 ， 让 所 有 列 线 均 为 低 电 位 ， 检 查 行 线 是 否 为 低 。 如 果 行 线 为 低 ， 则 说 明 该 行 有 键 按 下 ， 否 则 说 明 无 键 被 按 下 。 


2) 如 果 某 行 有 键 被 按 下 ， 识 别 键盘 哪 一 列 的 键 被 按 下 ， 逐 列 置 低 电位 ， 并 置 其 余 列 为 高 电位 ， 检 查 各 行 线 电位 的 变化 。 如 果 行 电位 变 为 低 电 位 ， 则 可 确定 此 行 此 列 交 叉 点 处 按键 被 按 下 。 


3) 在 识别 按键 值 后 ，CPU 会 读 取 相 应 缓存 器 的 值 ， 并 且 把 键 值 反 映 到 上 层 引用 接口 ， 实 现 按键 功能 化 。 


2.Linux 操 作 系统 对 中 断 的 管理 


Linux 内 核 为 了 将 来 自 硬 件 设备 的 中 断 传 递 到 相应 的 设备 驱动 程序 ， 在 驱动 程序 初始 化 的 时 候 就 将 对 应 的 中 断 程 序 进 行 了 登记 ， 即 通过 调用 函数 request_irq( 将 其 中 信息 添加 到 结构 为 irqaction 的 数组 
从 而 使 中 断 号 和 中 断 服 务 程序 联系 起 来 。 


Request irq0 函 数 (include/linux/interrupt.h) 原型 如 下 : 


extern int _must check request irq(unsigned int, іга handler thandler,unsigned long, const char *, void *); 


另外 ，irqaction 的 数据 结构 如 下 (include/linux/interrupt.h) : 


struct irgaction { 

irq handler t handler; 
unsigned long flags; 

const char *name; 

void *dev id; 

struct irgaction *next; 

int іга; 

struct proc dir entry *dir; 
irq handler t thread fn; 
struct task struct *thread; 
unsigned long thread flags; 
1; 


当中 断 发 生 时 ，Linux 首 先 读 取 系统 中 断 控制 器 中 的 中 断 状 态 寄存 器 ， 判 断 出 中 断 源 的 中 断 设 备 号， 根据 设备 的 中 断 号 可 以 在 irqaction 的 数据 结构 链表 中 检索 到 设备 的 中 断 信息 ， 并 且 在 do_IRQ( 函 数 


中 处 理 所 有 的 外 设 中 断 请 求 。 


do _IRQ() 函 数 在 irq_desc[NR_IRQS] 全 域 变量 数组 中 找到 需要 响应 中 断 的 处 理 函 数 irq_desc[NR_IRQS] 的 数据 结构 为 irq_desc。 


free_irq() 为 释放 中 断 处 理 函 数 。 


下 面 结合 输入 /输出 系统 的 层次 结构 来 看 一 下 中 断 在 驱动 程序 工作 过 程 中 的 作用 。 


“ 使 用 者 发 出 菜 种 输入 /输出 请 求 。 

“ 调用 驱动 程序 的 s3c_keypad_isr0 函数 ， 开 局 内 核 程序 的 时 间 定 时 器 ， 扫 描 榨 键 位 ， 之 后 很 快 释放 按键 中 断 ， 等 待 下 一 次 中 断 产 生 。 

“ 一 小 段 时 间 后 ， 硬 件 设备 准备 好 完成 指令 的 操作 ， 并 产生 中 断 信 号 ， 这 标志 事件 的 发 生 。 

:中断 信 号 导致 调用 驱动 程序 的 中 断 服务 子 程序 ， 它 将 所 要 的 数据 从 硬件 设备 复制 到 设备 驱动 程序 的 缓冲 区 ， 并 作为 输入 信号 直接 写 入 CPU， 现 在 数据 可 以 使 用 。 


+ 在 数据 可 以 使 用 时 ，CPU 可 以 将 数据 提供 给 使 用 者 处 理 。 


上 述 过 程 虽 经 过 简化 ， 但 却 反 映 了 中 断 的 主要 过 程 的 主要 方面 。 


5.5.2 ”和 矩阵 键盘 硬件 原理 图 


1 .键盘 接口 电路 


如 图 5-56 所 示 ， 此 键盘 为 3x 2 的 矩阵 (根据 需要 去 掉 1 个 按键 ) 。 键 盘 的 输入 输出 端 分 别 被 3 路 GPH2 口 和 2 路 GPH3 口 控制 。 


图 5-56 矩阵 键盘 基本 原理 图 


2. 专 用 寄存 器 
控制 列 的 GPIO 控 制 器 如 表 5-32~ 表 5-35 所 示 。 
端口 组 GPH2 控 制 寄存 器 有 四 个 控制 寄存 器 : GPH2CON. СРН2РАТ, GPH2PUD#IGPH2DRV. 
(1) 端口 组 GPH2 控 制 寄存 器 (GPH2CON, 读 / 写 ， 地 址 =0xE020_0C40) 


表 5-32 GPH2 控 制 寄存 器 


GPH2CON 


GPH2CON[0] 


GPH2CON[1] 


GPH2CON[2] 


GPH2CON[3] 


GPH2CON[4] 


GPH2CON[5] 


[3:0] 


[7:4] 


[11:8 


md 


[15:12] 


[19:16] 


[23:20] 


0000 = fip À 

0001 = 输出 
0010 = 保留 

0011 - KP. COL[0] 
0011 ~ 1110 = 保留 
1111 = EXT INT[16] 


0000 = # A 

0001 = 输出 
0010 = 保留 

0011 = KP. СОЦІ] 
0011 ~ 1110 = 保留 
1111 = EXT INT[17] 
0000 = # A. 

0001 = 输出 
0010 = 保留 

0011 =KP_COL[2] 
0011 ~ 1110 = 保留 


1111 = EXT INT[18] 


0000 = fii A. 

0001 = 输出 
0010 = 保留 

0011 = КР COL[3] 
0011 ~ 1110 = 保留 
1111 = EXT INT[19] 


0000 = fii A. 

0001 = 输出 
0010 = 保留 

0011 = КР COL[4] 
0011 ~ 1110 = 保留 
1111 = EXT_INT[20] 


0000 = 输入 

0001 = 输出 
0010 = 保留 

0011 = КР COL[5] 
0011 ~ 1110 = 保留 
1111 = EXT_INT[21] 


初始 值 


0000 


0000 


0000 


0000 


0000 


0000 


GPH2CON 初始 值 
0000 = 输入 
0001 = 输出 
0010 = 保留 
GPH2CON[6] 0000 
0011 - KP COL[6] 
0011 ~ 1110 = 保留 
1111 = EXT INT[22] 
0000 = # Л 
0001 = 输出 
0010 = 保留 
GPH2CON[7] 0000 
0011 =KP_COL[7] 
0011 ~ 1110 = 保留 
1111 = EXT INT[23] 
(2) 端口 组 GPH2 数 据 寄 存 器 (GPH2DAT, 读 / 写 ,地 址 =0xE020_0C44) 
表 5-33 GPH2 数 据 寄存 器 
GPH2DAT 初始 值 
当 端 口 被 配置 为 输入 端口 ， 相 应 位 为 引 脚 的 
GPH2DAT[7:0] 状态 。 当 端口 配置 为 输出 端口 ， 引 脚 的 状态 是 
了 : ` 2 ч Z; = 、 x 
一 样 的 相应 位 。 当 端口 被 配置 为 功能 引 脚 ， 将 
读 取 未 定义 的 值 
(3) 端口 组 GPH2 上 拉 寄 存 器 (GPH2PUD， 读 / 写 ， 地 址 =0xE020 0C48) 
45-4 GPH2 上 拉 寄 存 器 
GPH2PUD 初始 值 
00= 禁 止 上 拉 / 下 拉 
[2n+1:2n] 01= 可 以 下 拉 
GPH2PUD[n] dh 0x0055 
n=0~7 10= 可 以 上 拉 
11 = 保留 
(4) 端口 组 GPH2 驱 动 强度 寄存 器 (GPH2DRV， 读 / 写 ， 地 址 =0xE020 OCA4C) 
#5-35 ”GPH2 了 驱动 强度 寄存 器 
GPH2DRV 初始 值 
[2n+1:2n| 
GPH2DRV[n] 0x000 


n=0~7 


控制 行 的 GPIO 控 制 器 如 表 5-36~ 表 5-39 所 示 。 


端口 组 GPH3 控 制 寄存 器 有 四 个 : СРНЗСОМ, СРНЗРАТ, СРНЗРОРТПСРНЗРВУ, 


(1) 端口 组 GPH3 控 制 寄存 器 (GPH3CON， 读 / 写 ， 地 址 =0xE020_0C60) 


5-36 СРНЭ FAR 


GPH3CON 


GPH3CON[0] 


GPH3CON[1] 


GPH3CON[2] 


GPH3CON[3] 


GPH3CON[4] 


GPH2CON[S] 


[3:0] 


0000 = 输入 

0001 = 输出 
0010 = 保留 

0011 = КР ROW[0] 
0011 ~ 1110 = 保留 
1111 = EXT INT[24] 
0000 = # A 

0001 = 输出 
0010 = 保留 

0011 = КР ROW[1] 
0011 ~ 1110 = 保留 
1111 = EXT INT[25] 
0000 = 输入 

0001 = 输出 
0010 = 保留 

0011 - KP ROW[2] 
0011 ~ 1110 = 保留 
1111 = EXT_INT[26] 
0000 = 输入 

0001 = 输出 
0010 = 保留 

0011 - KP ROW[3] 
0011 ~ 1110 = 保留 
1111 = EXT_INT[27] 
0000 = А. 

0001 = 输出 
0010 = 保留 

0011 = КР ROW[4] 
0011 ~ 1110 = 保留 
1111 = EXT INT[28] 
0000 = 输入 

0001 = 输出 
0010 = 保留 

0011 =KP ROW[5] 
0011 ~ 1110 = 保留 
1111 = EXT_INT[29] 


初始 值 


0000 


0000 


0000 


0000 


0000 


0000 


GPH3CON 
GPH3CON[6] [27:24] 
GPH3CON[7] [31:28] 


(2) 端口 组 GPH3 数 据 寄存 器 (GPH3DAT， 读 / 写 ， 地 址 =0xE020_0C64) 


GPH3DAT 


GPH3DAT[7:0] 


(3) 端口 组 GPH3 上 拉 寄 存 器 (GPH3PUD, 读 / 写 ,地 址 =0xE020_0C68) 


GPH3PUD 


[2n+1:2n] 


GPH3PUD[n] m 
n= 一 


(4) 端口 组 GPH3 驱 动 强度 寄存 器 (GPH3DRV， 读 / 写 ， 地 址 =0xE020 OC6C) 


GPH3DRV 


[2n+1:2n] 
n=0~7 


GPH3DRV[n] 


5.5.3 ”键盘 驱动 程序 设计 


在 DMA-210XP 实 验 平台 上 配置 有 矩阵 式 键盘 ， 由 GPIO 


1. 内 核 驱 动 


DMA-210XP 实 验 平台 把 键盘 设计 为 一 种 输入 装置 ， 不 仅 可 以 实现 按键 键 值 的 输入 输出 ， 还 可 以 实现 按键 功能 化 ， 在 上 


键 、 主 界面 功能 键 等 多 项 功能 。 所 以 在 驱动 架构 上 和 普通 的 按键 驱动 是 有 区 别 的 。 下 面 对 键 盘 驱动 程序 进行 说 明 。 


(1) 虚拟 内 存 映像 以 及 设备 资源 配置 


Sn, 


接 


内 可 以 灵活 控制 各 个 应 


(2) 


初始 值 
0000= 输入 
0001 = 输出 
0010 = 保 贸 
保留 0000 
0011 = КР ROW[6] 
0011 ~ 1110 = 保留 
1111 = EXT INT[30] 
0000 = 输入 
0001 = 输出 
0010 = fB 
保留 0000 
0011 = КР ROW[7] 
0011 ~ 1110 = {$f 
1111 = EXT INT[31] 
437 GPH3 数 据 寄存 器 
初始 值 
当 端 口 被 配置 为 输入 端口 ， 相 应 位 为 引 脚 的 状态 。 当 端口 配 
置 为 输出 端口 ， 引 脚 的 状态 是 一 样 的 相应 位 。 当 端口 被 配置 为 0x00 
功能 引 脚 ， 将 读 取 未 定义 的 值 
#5-38 GPH3 上 拉 寄 存 器 
初始 值 
00= 禁 目 上 拉 / 下 拉 
01= 可 以 下 拉 
Ox0055 
10= 可 以 上 拉 
11 = 保留 
表 5-39 GPH3 了 驱动 强度 寄存 器 
初始 值 
0x000 


口 的 GPH2 和 GPH3 端 口 与 3x 2 矩阵 式 键盘 接口 。 编 写 Android 和 矩阵 式 键盘 驱动 程序 ， 实 现 对 矩阵 式 键盘 扫描 ， 并 将 结果 显示 在 LCD 屏 幕 上 。 


程序 的 操作 。 如 音量 放大 、 音 量 减 小 、 返 


keypad mem = request_mem_region(res->start, size, pdev-»name); 
L) ( 


if (keypad mem — NUL 


dev err(&pdev-»dev, "failed to get memory region Wn"); 


ret = -ENOENT; 
goto err req; 


key base = ioremap(res-»start, size); 

if (key base — NULL) ( 

pr err("Failed to remap register block\n"); 
ret = -ENOMEM; 

goto err map; 


} 

keypad clock = clk_get (&pdev->dev, "keypad"); 

if (IS | ERR (keypad ‹ clock)) { 

dev err(&pdev-»dev, "failed to find keypad clock source\n") 
ret = PTR ERR(keypad clock); 

goto err clk; 

} 

Clk enable (keypad clock); 

S3c keypad = kzalloc(sizeof(struct s3c keypad), GFP KERNEL); 
input dev = input allocate device(); 

if (!s3c : keypad | | !'input dev) { 

ret = -ENOMEM; 

goto err_alloc; 

} 

platform set drvdata(pdev, s3c keypad); 

S3c keypad-»dev = input dev; ` 


这 部 分 程序 


要 关注 的 是 设备 资源 的 分 配 ， 通 过 input_allocate_device 函 数 为 新 的 输入 装置 申请 一 段 内 存 资源 ， 这 样 CPU 就 可 以 直接 读 写 该 段 内 存 中 的 值 。 


(2) 缓存 器 初始 化 配置 以 及 GPIO 设 置 


writel (KEYIFCON_INIT, key base+S3C_KEYIFCON) ; 

writel (KEYIFFC | DIV, key | base+S3C ` KEYIFFC) ; 

/* Set GPIO Port for keypad mode and pull-up disable*/ 
S3c setup keypad cfg gpio(KEYPAD ROWS, KEYPAD COLUMNS); 
writel(KEYIFCOL CLEAR, key basetS3C KEYIFCOL); 


要 实现 对 3x 2 键盘 的 控制 ， 必 须 对 其 控制 的 GPIO 实 现 可 读 可 写 ， 相 应 的 GPIO 初 始 化 配置 如 下 : 


void s3c_setup_keypad_cfg_gpio(int rows, int columns) 

{ 

unsigned int gpio; 

unsigned int end; 

end = S5PV210 GPH3 (rows); 

/* Set all the necessary GPH2 pins to special-function 0 */ 
for (gpio = S5PV210_GPH3(0); gpio < end; gpio++) { 

s3c : gpio | cfgpin (gpio, S3C GPIO SEN(3)) ; 

S3c « : gpio setpull(gpio, S3C | GPIO | PULL UP); 


} 

writel (0х0, S5PV210 GPH3 BASE + 0x08); 

end = S5PV210 GPH2 (columns); 

/* Set all the necessary GPK pins to special-function 0 */ 
for (apio = S5PV210 GPH2(0); gpio < end; gpio++) ( 

s3c : gpio ， cfgpin (gpio, S3C GPIO SEN(3)) ; 

s3c < : gpio_setpull (gpio, S3C | GPIO | PULL NONE); 


} 
writel (0x0, S5PV210_GPH2 BASE + 0x08); 
} 


通过 以 上 程序 把 相应 的 GPH2 和 GPH3 作 为 特殊 功能 引 脚 使 用 。 


(3) 把 键盘 配置 为 输入 装置 ， 并 对 键盘 驱动 进行 注册 


/* create and register the input driver */ 

set bit (EV KEY, input_dev->evbit) ; 

s3c | ` keypad-»nr . rows = KEYPAD ROWS; 

s3c_keypad->no_cols = KEYPAD COLUMNS; 
s3c_keypad->total_keys = MAX KEYPAD NR; 

for (key = 0; key < s3c_keypad->total_keys; key++) { 
code = s3c ' keypad->keycodes [key] = keypad_keycode [key] ; 
if (code <= 0) Е 

continue; 

set_bit (code & KEY MAX, input_dev->keybit) ; 

} 

input dev->name = DEVICE NAME; 

input dev-»phys = "s3c-keypad/input0"; 

input dev-»id.bustype = BUS HOST; 

input dev-»id.vendor = 0x0001; 

input dev-»id.product = 0x0001; 

input dev-»id.version = 0х0001; 

input dev-»keycode = keypad keycode; 

/* Scan timer init */ 

init timer(&keypad timer); 

keypad timer.function = keypad timer handler; 

keypad timer.data = (unsigned long)s3c keypad; 

/* For IRQ KEYPAD */ 

keypad іга = platform get resource (pdev, IORESOURCE_IRQ, 0); 
if (keypad irq — NULL) { 

dev err(&pdev-»dev, "по irq resource specified\n") ; 
ret = -ENOENT; 

goto err_irg; 

} 

ret = request irq(keypad irq-»start, s3c keypad isr, 0, 
DEVICE NAME, (void *) pdev); Е = 

if (ret) { 

pr err("request іга failed (IRQ KEYPAD) Nn"); 

ret = -EIO; 

goto err іга; 

} 

ret = input register device(input dev);// 注册 按键 驱动 
if (ret) { 

pr_err ("Unable to register s3c-keypad input device!!!\n"); 
goto out; 


} 


通过 上 述 程序 代码 注册 的 是 一 个 3x2 的 键盘 驱动 ， 对 应 的 键 值 为 : 


int keypad_keycode[] = { 

KEY VOLUMEDOWN, KEY KBDILLUMDOWN, 
KEY VOLUMEUP,KEY BACK,KEY НОМЕ, 0 
+ 


当 按 下 不 同 的 按键 时 ，CPU 就 会 读 取 不 同 的 键 值 ， 即 实现 不 同 的 按键 功能 。 其 中 KEY_VOLUMEDOWN 和 KEY_VOLUMEUP 分 别 对 应 的 是 音量 减 小 、 放 大 的 功能 ; KEY_KBDILLUMDOWN 对 应 的 是 
MENU 键 ， 设 置 系统 的 辅助 功能 ，KEY_BACK 对 应 的 是 返回 键 ; KEY_HOME 对 应 的 是 返回 主页 面 功能 键 。 


(4) 初始 化 内 核 程序 的 时 间 定 时 器 


/* Scan timer init */ 

init timer(&keypad timer); 

keypad ` timer.function - keypad timer handler; 
keypad timer.data = (unsigned long)s3c keypad; 


在 Linux 设 备 程序 设计 中 ， 大 都 是 通过 内 核 程序 的 时 间 定 时 器 来 控制 时 间 的 ， 在 这 里 按键 扫描 也 是 一 样 ， 一 旦 开启 内 核 程 序 的 时 间 定时 器 ， 系 统 就 自动 扫描 是 否 有 键 值 被 按 下 ， 这 其 中 涉及 一 个 重要 的 函 
数 : keypad_scan() 按 键 扫描 函数 ， 其 程序 代码 如 下 : 


static int keypad_scan (void) 


u32 col, cval, rval; 

pr_debug ("row val = $x", readl(key base + S3C KEYIFROW)); 
for (col = 0; col < KEYPAD COLUMNS; со1++) { 

/* clear that column number and make that normal output */ 
cval = KEYCOL DMASK & ~((1 << col) | (1 << (col + 8))); 
writel(cval, key base + S3C KEYIFCOL); 

udelay (KEYPAD DELAY); 

rval = -(readl(key base + S3C KEYIFROW)) & 

((1<<KEYPAD ROWS) = 1); Е 

keymask[col] = rval; 

} 


writel(KEYIFCOL CLEAR, key раѕе+53С KEYIFCOL); 
return 0; 


} 


在 以 上 扫描 程序 中 ， 一 旦 确定 有 按键 按 下 ， 就 会 把 相应 按键 信息 返回 到 处 理 函 数 keypad timer_handler 中 ， 然 后 把 确定 的 键 值 写 入 系统 CPU 中 。 


(5) 中 断 扫 描 


/* For IRQ KEYPAD */ 

keypad_irg = platform get resource (pdev, IORESOURCE_IRQ, 0); 
if (keypad_irg == NULL) í 

dev err(&pdev-»dev, "no irq resource specified\n"); 

ret = -ENOENT; 

goto err іга; 

} 

ret = request irq(keypad irq-»start, s3c keypad isr, 0, 
DEVICE NAME, (void *) pdev); 

if (ret) { 

pr err("request іга failed (IRQ KEYPAD) Nn"); 

ret = -EIO; 

goto err іга; 

} 

ret = input register device (input dev); 

if (ret) { 

pr err("Unable to register s3c-keypad input device!!! Wn"); 
goto out; 


) 


在 每 次 产生 中 断后 ， 系 统 都 会 通过 内 核定 时 器 来 释放 中 断 ， 然 后 重新 开启 定时 器 ， 等 待 下 次 中 断 的 产生 。 释 放 中 断 函数 代码 如 下 : 


static irqreturn t s3c keypad isr(int irg, void *dev id) 


{ 
/* disable keypad interrupt and schedule for keypad timer handler 
* 
/ 
writel (readl (key base + S3C KEYIFCON) & ~ (ІМТ F EN|INT В EN),key base + S3C_KEYIFCON) ; 
keypad timer.expires = jiffies + (HZ/100); 
if (is timer on == false) { 
add_timer (&keypad_timer) ; 
is_timer_on = true; 
} else {7 
mod timer(&keypad timer, keypad timer.expires); 


} 

/*Clear the keypad interrupt status*/ 

writel (KEYIFSTSCLR CLEAR, key base + S3C KEYIFSTSCLR); 
return IRQ HANDLED; 

f 


这 样 键盘 驱动 就 会 不 间断 地 在 释放 中 断 、 获 得 中 断 之 间 循 环 ， 为 系统 获取 键 值 不 断 地 做 出 响应 ， 保 证 按键 的 灵敏 度 。 


以 上 就 是 键盘 驱动 的 整个 程序 分 析 ， 通 过 加 载 键盘 驱动 ， 可 以 让 键盘 实现 和 触 控 式 屏幕 、 鼠 标 同样 的 功能 。 


2. 键 盘 界面 程序 设计 


前 面 已 经 介绍 了 如 何在 内 核 中 注册 按键 驱动 ， 接 下 来 编写 一 个 应 用 程序 来 读 取 按 键 的 值 。 本 小 节 将 介绍 如 何 设计 应 用 界面 以 读 取 按 键 的 值 。 具 体 步 又 如 下 。 


(1) 新 建 工程 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 


IR] 


5-57 所 示 菜 单 。 


New + 


Show In AlttShifttW P 


a=) Copy Ctrltc 
= Copy Qualified Name 
Ctrlty 
Delete 


5-57 Package Explorer € Ab 


2) 在 弹出 菜单 中 选择 “New” 一 “Project”， 如 图 5-58 所 示 。 


弹出 如 图 5-59 所 示 窗 口 。 


3) 选择 “Android” 一 “Android Project”， 点 击 “Next” 按 钮 。 弹 出 如 图 5-60 所 示 窗 口 ， 在 相应 位 置 填 入 信息 。 
k 4- ү. Po hte 
m. Froject. E 


AlttShiftt'" 


Copy Ctrl+c 
E Copy Qualified Name 

[а Paste CtrltV 
3€ Delete Delete 


图 5-58 ”新 建 工程 
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s Java Project 

С Java Project from Existing Ant Buildfile 
-g Plug-in Project 


"GS android Project 
i = 7 Android Test Project 
| le? Android XML File 
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(=> Plug-in Development 
| 8 User Assistance 
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š 


45-59 ”新建 工程 窗口 


Hew Android Project 


New Android Project 


Creates а new Android Project rezource. 


Project name: [Keypad P 55 5 
Contents 

(=) Create new project in workspace 

Create project from existing source 

[7]Usza default location 


L_éafats: on [c i ip le oF HS г 证 ef Kew T: k | 


(Create project from existing sample 


Samples: Арі Пето: 


Build Target 


Vendor 
Android Open 
Google Inc. 
Android Open 
Google Inc. 
Android Open 


Target Name 

[T] Android 1.5 
Google APIs 
Android 1.8 

| Google APIs 
Android 2.1... 


O00 


CJ 
LJ 
Г] 
L1 
CI 
Г] 
Г] 
Г] 
Г] 
Г] 
LE 
LJ 
L 


Google АРГя 
Android 2. 2 
Google APIs 
Android 2.3. 1 
Google APIs 


Android 2.3. З 


Google АРІ 
Android 3,0 
Google APIx 
Android 3,1 
Google APIs 
Android 3,2 
Google APIs 


Google Ine. 
Anda oi d Open 
Google Inc. 
Ande oid Open 
Google Inc. 
Android Open 
Google Ine. 
Android Open 
Google Inc. 
Android Open 
Gesgla Ine. 
Android Open 
Google Ine. 


Standard Android platform 1.5 


Proper %®1 ек 


Application name: 


Package name: 


[J] Create Activity: 


Mim SDK Version: 


Keyp ad 
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| dmatek. xch. keypad 
| Keypadác tivity 
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5-60 ”新 建 Android 项 目 窗口 


4) 点 击 “Finish” 按 钮 完成 创建 。 
(2) 编辑 main.xml 文 件 ， 进 行 UI 设 计 


xml 文 件 的 程序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<RelativeLayout 

xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:orientation-"vertical" 

android:layout widt fill parent" 

android:layout height-"fill parent" 

> 

<TextView 

android: id="@+id/widget28" 

android:layout width-"wrap content" 

android:layout height-"wrap content" 

android:layout centerInParent-"true" 

android: lc 
android: 
android:text-"Key Value:" 

> 

</TextView> 

<TextView 

android: id="@+id/mTextViewl" 

android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Please press key!" 
android: layout_below="@+id/widget28" 
android: layout_centerHorizontal="true" 
android: textColor="#£fff0f0£" 

android: textSize="25sp" 

> 

</TextView> 

<Button 

android: id="@+id/myButton1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Exit" T 
android:layout_alignParentBottom="true 
android:layout_centerHorizontal="true" 
> 

</Button> 

</RelativeLayout> 


这 个 布局 文件 设计 了 两 个 文本 框 和 一 个 按钮 ， 设 计 出 来 的 UI 如 图 5-61 所 示 。 


Bil] 3 12:53 PM 


Key Value: 


图 5-61 KeyPad 驱 动 界面 
(3) Keypad_Controljava 程 序 代码 编写 


导入 相应 的 包 文件 : 


package tw.com.dmatek.dma6410xp.keypad; 

import tw.com.dmatek.dma6410xp.R; 

import android.app.Activity; 

import android. inputmethodservice.Keyboard. Key; 
import android.os.Bundle; 

import android.view.View; 

import android.widget .Button; 

import android.widget.TextView; 

import android.view.KeyEvent; 


让 Keypad_Control 继承 Activity: 


public class Keypad_Control extends Activity{ 


定义 成 员 变 量 : 


public TextView mTextViewl; 
private Button mButtonl; 


实现 程序 第 一 次 启动 时 调用 的 方法 onCreate : 


GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


显示 布局 文件 : 


setContentView (R. layout. keypad) ; 


获取 资源 ID 实例 化 成 员 变 量 : 


mTextViewl = (TextView) findViewById(R.id.mTextView1) ; 
mButtonl = (Button) findViewById(R.id.myButton1) ; 


使 用 匿名 类 实现 Button 的 事件 处 理 ， 实 现 退 出 程序 功能 : 


mButtonl.setOnClickListener (new Button.OnClickListener () 
{ 

GOverride 

public void onClick(View v) 

{ 

finish (); 


n; 
} 


实现 onKeyDown 方 法 ， 获 取 键 值 ， 并 显示 : 


GOverride 
public boolean onKeyDown (int keyCode, KeyEvent event) 


{ 

// TODO Auto-generated method stub 
switch (keyCode) 

{ 

case KeyEvent.KEYCODE ENTER: 
mTextViewl.setText ("ENTER"); 
break; 

case KeyEvent.KEYCODE MENU: 
mTextViewl.setText ("MENU"); 
break; 

case KeyEvent.KEYCODE 0: 
mTextViewl.setText ("0"); 

break; 

case KeyEvent.KEYCODE 1: 
mTextViewl.setText ("1"); 

break; 

case KeyEvent.KEYCODE 2: 
mTextViewl.setText ("2"); 

break; 

case KeyEvent.KEYCODE 3: 
mTextViewl.setText ("3"); 

break; 

case KeyEvent.KEYCODE 4: 
mTextViewl.setText ("4"); 

break; 

case KeyEvent.KEYCODE 5: 
mTextViewl.setText ("5"); 

break; 

case KeyEvent.KEYCODE 6: 
mTextViewl.setText ("6"); 

break; 

case KeyEvent.KEYCODE 7: 
mTextViewl.setText ("7"); 

break; 

case KeyEvent.KEYCODE 8: 
mTextViewl.setText ("8"); 

break; 

case KeyEvent.KEYCODE 9: 
mTextViewl.setText ("9"); 

break; 

case KeyEvent.KEYCODE DPAD RIGHT: 
mTextViewl.setText ("RIGHT"); 
break; 

case KeyEvent.KEYCODE DPAD LEFT: 
mTextViewl.setText ("LEFT"); 
break; 

case KeyEvent.KEYCODE DPAD DOWN: 
mTextViewl.setText ("DOWN"); 
break; 

case KeyEvent.KEYCODE DPAD UP: 
mTextViewl.setText ("UP"); 

break; 

case KeyEvent.KEYCODE HOME: 
mTextViewl.setText ("HOME"); 
break; 

case KeyEvent.KEYCODE CALL: 
mTextViewl.setText ("CALL"); 
break; 

case KeyEvent.KEYCODE ENDCALL: 
mTextViewl.setText ("ENDCALL"); 
break; 

case KeyEvent.KEYCODE VOLUME DOWN: 
mTextViewl.setText ("VOLUME DOWN"); 
break; E 
case KeyEvent.KEYCODE VOLUME UP: 
mTextViewl.setText ("VOLUME UP"); 
break; 

case KeyEvent.KEYCODE BACK: 
mTextViewl.setText ("BACK"); 
break; 

case KeyEvent.KEYCODE DEL: 
mTextViewl.setText ("DEL"); 
break; 


return false; 


} 


ELSA, 4 опКеуромп (int keyCode, KeyEvent event) 属于 系统 调用 函数 ， 当 系统 检测 到 有 按键 按 下 时 ， 此 函数 被 自动 调用 ， 当 检测 到 按 下 的 按键 值 keyCode 为 KeyEvent 中 的 某 一 值 
时 ， 在 屏幕 上 显示 按键 值 。 此 实验 不 需要 调用 底层 驱动 ， 在 文件 系统 中 就 可 完成 此 功能 ， 故 不 需要 相应 的 SO 文件 来 调用 底层 驱动 。 


最 后 需要 说 明 的 一 点 ， 就 是 把 键盘 作为 一 种 输入 性 设备 ， 它 与 系统 CPU 的 联系 很 强 ， 不 同 的 键 值 、 不 同 的 中 断 响应 都 会 对 CPU 产生 不 同 的 影响 。 所 以 在 驱动 程序 中 特别 注意 相关 寄存 器 的 配置 ， 以 及 内 
存 的 分 布 ， 稍 有 差错 就 会 导致 系统 崩溃 。 


到 此 完成 了 键盘 测试 实验 设计 。 


测试 自己 编写 的 键盘 程序 ， 步 骤 如 下 : 


1) 打开 DMA-210XP 平 台 的 电源 ， 启 动 系统 。 


2) 安装 好 应 用 程序 (安装 方法 请 看 LED 中 的 实验 步骤 ) 。 


3) 启动 程序 。 


进入 KeyPAD 测 试 界面 ， 如 图 5-62 所 示 。 


Key Value: 


图 5-62 KeyPAD 界 面 


点 击 实验 平台 上 的 一 个 按键 ， 例 如 BACK 键 ， 在 屏幕 上 将 会 显示 其 按键 值 。 如 图 5-63 所 示 。 


点 击 实验 平台 上 的 一 个 按键 ， 例 如 音量 增加 键 ， 在 屏幕 上 将 会 显示 其 按键 值 。 如 图 5-64 所 示 。 


Key Value: 


BACK 


Key Value: 


图 5-64 音量 增加 键 


第 6 章 “外 设 接口 与 驱动 程序 


61 UART 串 行 接口 及 通信 程序 


6.1.1 UART 简 介 


S5PV210 的 通用 异步 接收 /发 送 装 置 (UART) 提供 了 四 个 独立 的 异步 串 行 输入 /输出 (1/0) 端口 。 所 有 端口 都 运行 在 中 断 或 DMA 模 式 下 。UART 控 制 器 可 以 在 CPU 和 UART 之 间 产 生 一 个 中 断 或 者 DMA 
请 求 来 传输 数据 。UART 支 持 的 比特 率 最 高 可 达 3Mbps。 每 个 UART 通 道 包含 两 个 FIFO 负 责 接收 和 发 送 数据 : 56 字 节 的 CH0，64 字 节 的 CH1 和 16 字 节 的 CH 和 CH3。 


UART 包 含 可 编程 的 波 特 率 ， 红 外 接收 /发 送 ， 插 入 一 个 或 两 个 停止 位 ，4~ 8 位 数据 宽度 和 奇偶 校 验 。 


每 个 UART 包 括 一 个 波 特 率 发 生 器 、 一 个 发 送 器 、 一 个 接收 器 和 一 个 控制 单元 。 波 特 率 发 生 器 的 输入 可 以 是 PCLK 或 者 UEXTCLK。 发 送 器 和 接收 器 包含 FIFO 和 移 位 寄存 器 ， 数 据 被 送 入 Tx FIFO， 然 后 复 
制 到 发 送 移 位 寄存 器 ， 然 后 数据 按 位 从 发 送 数据 引 脚 TxDn 输 出 。 同 时 ， 从 引 脚 RxDn 接 收 数据 发 送 到 移 位 寄存 器 ， 并 复制 到 Rx FIFO. 


1.UART 接 口 特性 


UART 接 口 的 特性 如 下 所 示 : 


- RXD0、TXD0、RXD1、TXD1、RxD2、TxD2、RXD3 和 TXD3 具 有 基于 DMA 或 基于 中 断 的 操作 。 


: UART 通 道 0、1、2、3 具 有 ItDA1.0。 


- UART 通 道 0 具 有 256 字 节 的 FIFO ， 通 道 1 具 有 64 字 节 的 FIFO ， 通 道 2 和 3 具有 16 字 节 的 FIFO 。 


+ UART 通 道 0、1 和 2 具有 nRTS0、nCTS0、nRTS1、nCTS1、nCTS2 和 nRTS2 自 动 流 控 制 。 


+ 支持 握手 的 发 送 /接收 。 


UART 的 结构 框图 如 图 6-1 所 示 。 
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图 6-1 UART 2544742 


2.UART 操 作 


下 面 介绍 UART 的 操作 ， 包 括 数据 传输 、 数 据 接 收 、 中 断 产生 、 波 特 率 产 生 、 环 回 模式 、 红 外 线 模式 和 自动 流量 控制 。 


(1) 数据 发 送 


数据 帧 发 送 是 可 编程 的 。 它 由 一 个 起 始 位 、5~ 8 个 数据 位 、 一 个 可 选 的 奇偶 位 和 1~2 个 可 由 行 控制 寄存 器 (ULCONn) 指定 的 停止 位 组 成 。 发 送 器 也 可 以 产生 中 断 条 件 ， 在 传输 过 程 中 ， 它 通过 置 位 逻 
辑 状态 0 来 强制 串 行 输出 。 当 目前 的 发 送 完全 传输 完成 后 ， 发 送 中 断 信 号。 然后 不 断 传送 数据 到 发 送 FIFO 寄 存 器 (在 非 FIFO 的 模式 下 ， 发 送 保存 寄存 器 ) 。 


(2) 数据 接收 


和 数据 发 送 一 样 ， 数 据 帧 接收 也 是 可 编程 的 。 它 由 一 个 起 始 位 、5~ 8 个 数据 位 、 一 个 可 选 的 奇偶 位 和 行 控制 寄存 器 指定 的 1~2 个 停止 位 组 成 。 接 收 器 可 以 检测 到 溢出 错误 、 奇 偶 错误 、 帧 错误 和 中 断 条 
件 ， 并 为 它们 设置 错误 标志 。 溢 出 错误 说 明 在 读 取 数 据 之 前 ， 新 的 数据 已 经 覆盖 原 有 的 数据 。 奇 偶 错误 说 明 接收 器 已 经 检测 到 一 个 意外 的 奇偶 条 件 。 帧 错误 表示 收 到 的 数据 没有 有 效 的 停止 位 。 中 断 条 件 表 
了 明 接 收 过 程 中 置 位 逻辑 状态 0 的 时 间 比 发 送 一 帧 的 时 间 长 。 当 三 个 字 的 时 间 (间隔 由 设置 的 字 长 决定 ) 间隔 内 没有 接收 任何 数据 ， 并 且 FIFO 模 式 下 接收 FIFO 寄 存 器 不 为 空 ， 产 生 接收 超时 条 件 。 


(3) 自动 流量 控制 


UART0 和 UART1 通 过 nRTS 和 mnCTS 信 号 支持 自动 流量 控制 (AFC) 。 某 种 情况 下 ， 它 可 以 连接 到 外 部 UART。 如 果 想 要 将 UART 和 一 台 调制 解 调 器 和 连接， 必须 在 UMCONn 寡 存 器 中 禁用 自动 流量 控制 
位 ， 并 且 通 过 软件 控制 信号 nRTS。 在 自动 流量 控制 过 程 中 ，nRTS 依 靠 接收 器 的 条 件 ，nCTS 信 号 控制 发 送 器 的 运作 。 只 有 激活 nCTS 信 号 (在 AFC 中 ，nCTS 表 示 另 一 个 UART 的 FIFO 寄 存 器 准备 接收 数 
йв) ，UART 的 发 送 器 发 送 FIFO 寄 存 器 中 的 数据 。 在 UART 接 收 数据 之 前 ， 如 果 它 接收 FIFO 寄 存 器 超过 两 个 字 节 以 上 的 空间 ， 则 激活 nRTS， 如 果 它 的 接收 FIFO 寄 存 器 只 有 不 足 一 个 字 节 的 空间 ，nRTS 则 停 
止 活动 (在 AFC 中 ，nRTS 表 示 自 己 的 FIFO 寄 存 器 准备 接收 数据 ) 。 图 6-2 显 示 了 UARTAFC 接 口 的 发 送 和 接收 状态 图 。 
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图 6-2 ОАКТАЕС о 


EF 自动 流量 控制 的 例子 ， 如 通过 软件 控制 NRTS 和 NCTS。 


ш 


(4) 接收 FIFO 的 操作 
Т) 选择 接收 模式 (中 断 或 DMA 模 式 ) 。 


2) 在 UFSTATn 中 查看 RXFIFO 计 数 器 的 值 。 如 果 该 值 小 于 15， 必 须 设置 UMCONn[0] 值 为 1 (激活 nRTS) ;如 果 该 值 等 于 或 大 于 15， 必 须 先 设 定 UMCONn[0] 值 为 0 (停止 nRTS) 。 


з) 重复 步骤 2。 


(5) 发 送 FIFO 的 操作 
Т) 选择 发 送 模式 〈 中 断 或 DMA 模 式 ) 。 
2) 检查 UMSTATn[0] 的 值 ， 如 果 这 个 值 是 1 (激活 nCTS) ， 则 写 数 据 到 发 送 FIFO 寄 存 器 。 


3) 重复 步骤 2。 


(6) RS-232C 接 口 


为 AFC 不 支持 RS- 


Бн 


要 将 UART 连 接 到 调制 解 调 器 接口 (而 不 是 零 调制 解 调 器 ) ， 需 要 nRTS、nCTS、nDSR、nDTR、DCD 和 nmnRI 信 号 。 在 这 种 情况 下 ， 可 以 通过 软件 来 控制 这 些 信号 与 一 般 的 MO 端口 。 


232C 接 口 。 


(7) 中 断 /DMA 请 求 的 产生 


S5PV210 中 每 个 UART 有 7 个 状态 (Tx/Rx/Error) 信号 : 溢出 错误 、 奇 偶 错误 、 帧 错误 、 中 断 、 接 收 缓冲 器 满 、 发 送 缓冲 器 空 和 发 送 移 位 寄存 器 空 。 这 些 状态 体现 在 UART 状 态 寄存 器 中 的 相关 位 
(UTRSTATn/UERSTATn) 。 

溢出 错误 、 奇 偶 错误 、 帧 错误 和 中 断 条 件 与 接收 错误 状态 相关 ， 如 果 控 制 寄 存 器 UCONn 中 的 receive-error-status-interrupt-enable 位 被 置 1 的 话 ， 每 个 错误 可 以 产生 一 个 接收 错误 状态 中 断 请 求 。 如 
果 探 测 到 一 个 receive-error-status-interrupt-enable 位 ， 通 过 读 UERSTATn 的 值 可 以 识别 这 一 中 断 请 求 。 


在 FIFO 模 式 中 ， 如 果 FIFO 寄 存 器 接收 到 移 位 寄存 器 传送 数据 发 送 的 数据 大 于 或 等 于 Rx FIFO 触 发 电 平 ， 且 接收 模式 控制 寄存 器 (UCONN) 被 设置 为 1 (中 断 请 求 或 轮 询 模式 ) ， 则 产生 Rx 中 断 。 在 非 
FIFO 的 中 上 断 请 求 和 轮 询 模式 中 ， 保 持 寄存 器 接收 到 移 位 寄存 器 传输 的 数据 将 产生 Rx 中 断 。 


imi 


如 果 发 送 器 从 其 发 送 FIFO 寡 存 器 传送 数据 到 发 送 移 位 器 和 对 数 的 数据 留 在 发 送 FIFO 小 于 或 等 于 Tx FIFO 中 的 触发 电 平 ， 将 产生 Tx 中 断 (依靠 发 送 模式 选择 控制 寄存 器 的 中 断 请 求 或 轮 询 模式 ) 。 非 FIFO 
模式 下 的 中 断 请 求 和 轮 询 模式 ， 移 位 寄存 器 接收 到 发 送 保持 寄存 器 传输 数据 将 产生 Tx 中 断 。 


注意 : 如 果 发 送 的 FIFO 中 的 数据 小 于 触发 电 平 总 是 产生 Tx 中 断 。 这 意味 着 除非 填写 Tx 缓冲 区 ， 否 则 一 有 中 断 请 求 将 产生 Tx 中 断 。 建 议 先 填写 Tx 缓冲 区 ， 然 后 启用 Tx 中 断 。 


S5PV210 的 中 断 控制 器 是 电 平 触发 型 。 如 果 对 UART 控 制 寄 存 器 编程 必须 设置 中 断 类 型 为 “ 电 平 ”。 


如 果 控制 寄 存 器 的 接收 和 发 送 模式 被 选择 为 DMAn 请 求 模式 ， 那 么 在 上 述 情况 下 DMAn 请 求 将 代替 Rx 或 Tx 中 断 发 生 ， 如 表 6-1 所 示 。 


表 6-1 与 FIFO 相 连 的 中 断 


如 果 


接收 缓冲 区 已 满 将 由 接收 保持 寄存 器 产生 中 断 。 


Rx FIFO 计数 高 于 或 等 于 FIFO ВУ ji 
х FIFO HRC RSET EW FIFO 人 | 如果 Rx FIFO 计数 高 于 或 等 于 接收 FIFO 的 触发 电 


发 电 平 则 产生 中 断 。 如 果 FIFO 中 数据 未 达到 Rx 
FIFO 和 触发 电 平 并 且 在 3 个 时 间 周 期 内 (接收 超时 ) 
将 产生 中 断 。 时 间 周 期 由 字 长 bit 设 定 


接受 中 断 


平 则 产生 中 断 。 如 果 FIFO 中 数据 未 达到 Rx FIFO 
触发 电 平 并 且 在 3 个 时 间 周 期 内 (接收 超时 ) 将 产 
生 中 断 。 时 间 周 期 由 字 长 bit 设 定 

Tx FIFO 计数 低 于 或 等 于 发 送 FIFO 出 发 电 | 当 发 送 缓冲 区 的 数据 变 为 空 ， 发 送 保持 寄存 器 产 
FIFO 触发 电 平 ) 则 产生 中 断 生 一 个 中 断 


当 洪 出 错误 、 奇 偶 错 误 、 帧 错误 、 中 断 信 号 被 检 
测 到 时 产生 


- 如 果 
发 送 中 断 P (Tx 
错误 中 断 


(8) UART 错 误 状 态 FIFO 


除了 Rx FIFO 寄 存 器 之 外 ，UART 还 : 


如 果 同 时 发 生 多 个 错误 ， 则 只 产生 一 个 中 断 


有 一 个 错误 状态 FIFO。 错 误 状 态 FIFO 表 示 了 在 FIFO 寄 存 器 中 ， 哪 一 个 数据 在 接收 时 出 错 ， 错 误 中 断 发 生 在 读 取 有 错误 的 数据 时 。 为 清除 错误 状态 FIFO， 需 要 读 取 


寡 存 器 URXHn 和 UERSTATn。 


例如 : 假设 UART 的 Rx FIFO 连 续 接 | 


收 到 A、B、C、D 字 符 ， 并 且 在 接收 B 字 符 时 发 生 了 帧 错误 〈 即 该 字符 没有 停止 位 ) ， 在 接收 D 字 符 时 发 生 了 奇偶 校 验 错 。 虽 然 UART 错 误 发 生 了 ， 但 是 不 会 产生 错误 


中 断 ， 因 为 含有 错误 的 字符 还 没有 被 CPU 读 取 。 


(9) 红外 线 (IR) 模式 


S5PV2100 的 UART 模 块 支持 红外 线 


3.UART 专 用 寄存 器 


(1) UART 行 控制 寄存 器 


(IR) 发 送 和 接收 ， 可 以 通过 设置 UART 控 制 寄存 器 (ULCONn) 中 的 红外 模式 位 来 选择 这 一 模式 。 


UART 模 块 中 有 四 个 UART 线 控制 寄存 器 : ULCON0、ULCON1、ULCON2 和 ULCON3， 如 表 6-2 所 示 。 


+ ULCONO, R/W, Address=0xE90_0000 


- ULCON1, R/W, Address=0xE90_0400 


+ ULCON2, R/W, Address=0xE90_0800 


- ULCON3, R/W, Address=0xE90_0C00 


位 名 称 


Reserved 


Infra-Red Mode 


Parity Mode 


Number of Stop Bit 


Word Length 


表 6-2 UART 行 控制 寄存 器 


人 


位 
[31: 
确定 是 否 采用 红外 模式 : 
[6] 0 = 普通 操作 模式 
1= 红外 线 输出 /接收 模式 


TE UART 发 送 /接收 操作 过 程 中 确定 奇偶 产生 类 型 和 校 验 : 
0xx = 无 校 验 

100 = 奇 校 验 

101 = 偶 校 验 

110 = 奇偶 强制 / 校 验 为 1 

111 = 奇偶 强制 / 校 验 为 0 

确定 每 帧 中 停止 位 个 数 : 

0 = fidt 1 位 停止 位 

1 = fiiit 2 位 停止 位 


确定 每 帧 中 数据 位 个 数 : 
[1:0] 


初始 状态 


000 


00=5 位 01=6 位 
10=7 位 11=8 位 


(2) UART 控 制 寄存 器 

UART 模 块 中 有 四 个 UART 控 制 寄 存 器 : UCON0、UCON1、UCON2 和 ULCON3， 如 表 6-3 所 示 。 
+ UCONO, R/W, Address=0xE90_0004 

* UCON1, R/W, Address=0xE90_0404 

+ UCON2, R/W, Address=0xE90_0804 


- UCON3, R/W, Address=0xE90_0C04 


( 续 ) 


Tx DMA 脉冲 [20] Tx DMA 传输 尺寸 
Size 0=1byte( 独 立 )，1=4byte 


Rx DMA 脉冲 Rx DMA 传输 尺寸 
. [16] p^ 0 
Size 0=1byte( 独 立 )，1 = 4 byte 


Reserved [15:11] 保留 0000 


表 6-3 UART 控 制 寄存 器 


| 从 时 钟 控 制 器 选择 PCLK 或 SCLK_UART 作为 ОАВТ 的 波 特 率 
Clock Selection [10] 00 
0=PCLK: DIV_VAL1 )=(PCLK /(bps x 16) )-1 
中 断 请 求 类 型 
Tx Interrupt Type [9] 0= 脉冲 0 
1= 电 平 
中 断 请 求 类 型 
Rx Interrupt Type [8] 0= 脉冲 0 
Rx Time Out UART FIFO 有 效 时 Rx 超时 中 断 使 能 ， 此 中 断 是 一 个 接收 中 断 
[7] x M" 0 
Enable 0= AM, 1= 有效 
在 接收 操作 中 出 现 中 断 、 帧 错误 、 奇 偶 错误 或 溢出 错误 ，UART 
Rx Error Status 产生 异常 中 断 使 能 0 
Interrupt Enable 0= 接收 错误 状态 不 产生 中 断 


1= 接 收 错误 状态 产生 中 断 
设置 UART 的 loop-back bit 为 1 进入 回环 模式 ， 此 模式 只 用 于 
Loop-back Mode 测试 0 
0= 普 通 模 式 ，1 = 回环 模式 
在 一 个 帧 时 间 内 设置 UART， 该 位 将 发 送 中 断 信号 。 发 送 中 断 
Send Break Signal 言 号 后 改 为 自动 清除 0 
0= 正常 发 送 ，1 = 发 送 中 断 信 和 号 
决定 以 哪 种 方式 将 Tx 的 数据 写 人 UART 发 送 缓冲 寄存 器 
Transmit Mode 00= 失效 01 = 中 断 请 求 或 轮 询 模式 00 
10=DMA 模式 ，11 = 保留 
决定 以 哪 种 方式 读 入 UART 接收 缓冲 寄存 器 的 数据 
Receive Mode š 00 = 失效 01 = 中 断 请 求 或 轮 询 模式 00 
10=DMA 模 式 ，11= 保留 


(3) UART 的 FIFO 控 制 寄 存 器 

UART 模 块 中 有 四 个 UART FIFO 控 制 寄 存 器 : UFCONO、UFCON1、UFCON2 和 UFCON3， 如 表 6-4 所 示 。 
: UFCONO, R/W, Address=0xE90_0008 

+ UFCON1, R/W, Address=0xE90_0408 

: UFCON2, R/W, Address=0xE90_0808 

+ UFCON3, R/W, Address=0xE90_0C08 


表 6-4 UART 的 FIFO 控 制 寄存 器 


位 名 称 


Tx FIFO Trigger Level 


Reserved 


Rx FIFO Trigger Level 


Reserved 


Tx FIFO Reset 


Rx FIFO Reset 
FIFO Enable 


(4) UART 接 收 (Rx) / (Tx) 发 送 状态 寄存 器 


[7] 


[6:4] 


[ 通道 0] 
000 = 0 byte 
010 = 64 bytes 
100 = 128 bytes 
110 = 192 bytes 
[通道 1] 
000 = 0 byte 
010 = 16 bytes 
100 = 32 bytes 
110 = 48 bytes 
[通道 3] 
000 = 0 byte 
010 = 4 bytes 
100 = 8 bytes 
110 = 12 bytes 


[ 通道 0] 

000 = 32 bytes 
010 = 96 bytes 
100 = 160 bytes 
110 = 224 bytes 
[通道 1] 

000 = 8 bytes 
010 = 24 bytes 
100 = 40 bytes 
110 = 56 bytes 
[ 通道 3] 

000 = 2 bytes 
010 = 6 bytes 
100 = 10 bytes 
110 = 14 bytes 


0= ЈЕ 


0= ЈЕ 
0 =FIFO 禁止 


Reserved 
确定 Tx FIFO 的 触发 电 平 。 如 果 Tx FIFO 数据 计数 小 于 
或 等 于 触发 电 平 ， 将 产生 Tx 中 断 


001 = 32 bytes 
011 = 96 bytes 
101 = 160 bytes 
111 = 224 bytes 


001 = 8 bytes 

011 = 24 bytes 
101 = 40 bytes 
111 = 56 bytes 


001 = 2 bytes 
011 = 6 bytes 
101 = 10 bytes 
111 = 14 bytes 


确定 Rx FIFO 的 触发 电 平 。 如 果 Rx FIFO 数据 计数 小 于 
或 等 于 触发 电 平 ， 将 产生 Rx 中 断 


001 = 64 bytes 

011 = 128 bytes 
101 = 192 bytes 
111 = 256 bytes 


001 = 16 bytes 
011 = 32 bytes 
101 = 48 bytes 
111 = 64 bytes 


001 = 4 bytes 
011 =8 bytes 
101 = 12 bytes 
111 = 16 bytes 


Tx 复位 ， 该 位 在 FIFO 复位 后 自动 清除 


1= Tx FIFO 复位 


Rx 复位 ， 该 位 在 FIFO 复位 后 自动 清除 
1= Rx FIFO 复位 


1 = FIFO 模式 


UART 模 块 有 四 个 UART 接 收 /发 送 状 态 寄存 器 : UTRSTAT0、UTRSTAT1、UTRSTAT2 和 UTRSTAT3， 如 表 6-5 所 示 。 


* UTRSTATO, К, Address=0xE90_0010 


* ОТКЅТАТІ, R, Address=0xE90_0410 


+ UTRSTAT2, R, Address=0xE90_0810 


初始 状态 


00 


00 


: UTRSTAT3, К, Address=0xE90_0C10 


46-5 UART 接 收发 送 状 态 寄存 器 


位 名 FR ж ж 初始 状态 
Reserved 
在 发 送 缓冲 寄存 器 没有 有 效 数据 或 发 送 移 位 寄存 器 为 空 
寸 ， 该 位 自动 置 
Transmitter empty [2] Í А еза A l 
1 = 发 送 空 (包括 发 送 缓冲 寄存 器 和 移 位 寄存 器 ) 
发 送 缓冲 寄存 器 为 空 时 ， 该 位 自动 置 1 
0= 缓冲 寄存 器 不 为 空 
1 = 缓冲 寄存 器 为 空 ( 非 FIFO 模式 ,中 断 或 DMA 请 求 )， 
Transmit buffer empty [1] ТЕ FIFO 模式 下 ， 如 果 Tx FIFO 触发 电 平 被 设置 为 00 (23), 1 
则 产生 中 断 请 求 或 DMA 请 求 。 如 果 UART 使 用 FIFO 则 保 
持 UFSTAT 寄存 器 的 Tx FIFO 的 Count bits 和 Full bit， 而 不 
对 该 位 检测 
Receive data 
[0] 


ready buffer 


如 果 缓 冲 寄存 器 通过 RXDn 端口 接收 的 数据 包含 有 效 数 

据 ， 该 位 被 自动 置 为 1 
0 = 缓冲 寄存 器 为 空 Š 
1 = 缓冲 寄存 器 收 到 数据 GE FIFO 模式 ， 中 断 或 DMA 请 

求 )， 如 果 UART 使 用 FIFO 则 保持 UFSTAT 寄 存 器 的 Rx 


FIFO 的 Count bits 和 Full bit， 而 不 对 该 位 检测 


(5) UART 发 送 缓冲 寄存 器 (保存 寄存 器 和 FIFO 寄 存 器 ) 

UART 模 块 有 四 个 发 送 缓冲 寄存 器 : UTXHO、UTXH1、UTXH2 和 UTXH3。UTXHn 有 一 个 8 位 数据 作为 发 送 数 据 。 
+ UTXHO, W, Address=0xE90_000 

- UTXH1, W, Address=0xE90_040 

+ UTXH2, W, Address=0xE90_080 

- UTXH3, W, Address=0xE90_0C0 

(6) UART 接 收 缓冲 寄存 器 (保存 寄存 器 和 FIFO 寡 存 器 ) 

UART 模 块 有 四 个 接收 缓冲 寄存 器 : URXHO、URXH1、URXH2 和 URXH3，URXHn 有 一 个 8 位 数据 作为 发 送 数据 。 
* URXHO, R, Address=0xE90_004 

- URXH1, R, Address=0xE90_044 

- URXH2, R, Address=0xE90_084 

- URXH3, К, Address=0xE90_0C4 

(7) UART 波 特 率 分 频 寄存 器 

UART 模 块 有 四 个 波 特 率 分 频 寄 存 器 : UBROIV0、UBRDIV1、UBRDIV2 和 UBRDIV3， 如 表 6-6 所 示 。 

- UBRDIVO, R/W, Address=0xE90_008 

- UBRDIV1, R/W, Address=0xE90_048 

- UBRDIV2, R/W, Address=0xE90_088 

- UBRDIV3, R/W, Address=0xE90_0C8 


表 6-6 UART 波 特 率 分 频 寄 存 器 


BROW at 


UBRDIVn |[15:0] | 波 特 率 分 频 值 ( 当 PCLK 是 UART 的 时 钟 源 ,UBRDIVn 必须 大 于 (UBRDIVn > 0 ))| | 0x0000 


(8) UART 通 道 波 特 率 除数 寄存 器 


UART 模 块 有 四 个 波 特 率 除数 寄存 器 : UDIVSLOT0、UDIVSLOT1、UDIVSLOT2 和 UDIVSLOT3， 如 表 6-7 所 示 。 


+ UDIVSLOTO, R/W, Address=0xE90_00C 
+ UDIVSLOT1, R/W, Address=0xE90_04C 
: UDIVSLOT2, R/W, Address=0xE90_08C 
: UDIVSLOT3, R/W, Address=0xE90_0CC 
表 6-7 UART 

UDIVSLOTn 


Reserved 


UDIVSLOTn 


E 


UART 波 特 率 配 置 。 


波 特 率 除数 寄存 器 (UBRDIVn) 除 以 分 频 寄存 器 (UDIVSLOTn) 中 存储 的 值 ， 用 来 确定 串 


DIV_VAL=UBRDIVn+ (num of 1's in UDIVSLOTn) /16 
DIV_VAL= (PCLK/ (bpsx16) ) -1 

或 者 
DIV_VAL= (SCLK_UART/ (bpsx16) ) -1 


其 中 除数 从 1 到 16。 


使 用 UDIVSLOT， 可 以 更 精确 地 产生 波 特 率 。 


例如 ， 如 果 波 特 率 为 1500 bps，SCLK_UART 为 40 MHz， 则 UBRDIVn 和 UDIVSLOTn 是 : 
DIV_VAL= (40000000/ (11500X16) ) -1 

=1.7-1 

=0.7 

UBRDIVn=0 (DIV_VAL 的 整数 部 分 ) 

(num of 1's in UDIVSLOTn) /16=0.7 


ЯВА, (num of 1's іп UDIVSLOTn) =11 


因此 ，UDIVSLOTn 可 以 是 1110_1110_1110_1010 或 者 0111 0111 0111 010155, 
2) UART 时 钟 和 PCLK 的 关系 。 
PCLK 与 UARTCLK 的 比例 有 时 钟 频率 的 约束 。 
UARTCLK 的 频率 与 PCLK 的 频率 的 比值 必须 不 超过 6.5/3 倍 : 
FUARTCLK<=6.5/3xFPCLK 
FUARTCLK=baudratex16 
这 样 做 可 以 有 足够 的 时 间 将 所 接收 的 数据 写 入 Rx FIFO, 
(9) UART 中 断 源 待定 寄存 器 


中 断 处 理 寄存 器 包括 产生 中 断 的 信息 ， 如 表 6-8 所 示 。 


通道 波 特 率 除数 寄存 器 


的 Tx/Rx 时 钟 速率 ( 波 特 率 ) 如 下 : 


表 6-8 UART 中 断 源 待定 寄存 器 


UINTSPn 位 


产生 调制 解 调 中 断 


RXD [0] 产生 接收 中 断 


(10) UART 中 断 屏蔽 寄存 器 


fox 


产生 错误 中 断 


UART 模 块 有 四 个 中 断 屏蔽 寄存 器 : UINTM0、UINTM1、UINTM2 和 UINTM3， 如 表 6-9 所 示 。 


+ UINTMO, R/W, Address=0xE90_0038 


* UINTM1, R/W, Address=0xE90_0438 
- UINTM2, R/W, Address=0xE90_0838 
* UINTM3, R/W, Address=0xE90_0C38 


中 断 屏 蔽 寄存 器 包含 那些 中 断 源 被 屏蔽 的 信息 。 如 果 一 个 特定 的 位 被 设置 为 1， 中 断 控制 器 将 不 产生 中 断 请 求 信号 ， 即 使 相应 的 中 断 是 生成 的 。 (注意 : 即使 在 这 样 的 情况 下 ，UINTSPn 寄 存 器 所 对 应 
的 位 也 被 设置 为 1。) 如 果 屏 蔽 位 是 0， 为 相应 中 断 源 的 中 断 请 求 提供 服务 。 


表 6-9 UART 中 断 屏蔽 寄存 器 


UINTSPn 位 ж x 复位 值 


MODEM [3] 屏蔽 调制 解 调 中 断 0x0 
TXD [2] 屏蔽 发 送 中 断 0х0 


RXD [0] 屏蔽 接收 中 断 0х0 


6.1.2 ”UART 接 口 及 操作 


1.UART 接 口 电路 


mn 


DMA-210XP 设 置 了 两 个 串 行 端口 ， 分 别 为 UART0 和 UART3。 其 中 UART0 使 用 GPA0_0 和 GPA0_1 作 为 数据 线 ; 使 用 GPA0_2 和 GPA0_3 作 为 控制 线 ; UART3 使 用 GPA1_2 和 GPA_3 作 为 数据 线 。 串 行 接 


口 电 路 如 图 6-3 所 示 。 
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2.Linux 串 行 接口 操作 


同 所 有 设备 一 样 ，Linux 也 是 通过 设备 文件 来 读 写 串 行 口 数据 ， 即 在 读 写 时 打开 相应 设备 文件 。 在 S5PV210 处 理 器 内 部 有 4 个 UART 单 元 ， 但 这 里 只 留 了 两 个 ， 串 行 端口 接口 UART0 和 UART3 分 别 对 应 的 
设备 文件 /dewttySAC0 和 /dewttySAC3。 


串 行 端口 操作 函数 
串 行 端口 操作 函数 如 下 : 
"Open 用 于 打开 串 行 口 设备 。 
+ Close 用 于 关闭 串 行 口 设备 。 
Read 用 于 从 囊 行 端口 设备 上 读 取 数据 。 
+ Write 用 于 往事 行 端口 设备 上 写 数 据 。 


` Ioctd 用 于 串 行 口 设备 除 读 / 写 外 的 控制 操作 。 


在 串 行 端口 通信 中 ，termios.h 是 个 很 重要 的 头 文件 。 


了 端口 属性 。 


эх 


可 使 用 tcgetattr0 和 tcsetattr() 函 数 获取 和 设置 串 


Tcgetattr(int _ fd,struct termios * _ termios p) 
Tcsetattr(int _ fd,int — optional actions, const struct termios 
* termios p) 


其 中 ，termios 结 构 体 是 定义 在 Linux 内 核 里 的 数据 结构 ， 用 于 存放 串 行 端 


Termios 结 构 定义 如 下 : 


属性 。 


struct termios { 

tcflag t c iflag; /* input mode flags */ 
tcflag t c oflag; /* output mode flags */ 
tcflag t c cflag; /* control mode flags */ 
tcflag t c lflag; /* local mode flags */ 
cc t c line; /* line discipline */ 

cc t c cc[NCCS]; /* control characters */); 


对 串 行 端口 属性 的 设置 主要 是 对 c_cflag 参 数 的 不 同位 进行 AND 或 OR 操 作 。 


对 波 特 率 的 设置 使 用 函数 cfsetispeed(0 和 cfsetospeed(。 这 两 个 函数 分 别 设置 入 口 端 和 出 口 端的 速率 ， 它 们 也 是 通过 改变 structtermios 结 构 来 实现 的 。 


Cfsetispeed(struct termios * _ termios p,speed t _ speed) 
Cfsetospeed(struct termios * _ termios p,speed t _ speed) 


可 按 如 下 语句 设置 波 特 率 : 


SerialPara.c_cflag |= Baud 


设置 数据 流 控制 : 


Termios.c_cflag &= ~ CRTSCTS 
Termios.c_cflag |= CRTSCTS 
Termios.c_cflag |= IXON | IXOFF | IXANY 


设置 数据 位 : 


Termios.c_cflag &=~ CSIZE 
Termios.c_cflag |= CS8 
Termios.c_cflag |= CS7 


设置 同位 检查 位 : 


Termios.c_cflag & =~ PARENB 
Termios.c_cflag |= PARENB 
Termios.c_cflag & = PARODD 
Termios.c_cflag |= PARENB 
Termios.c_cflag & =~PARODD 


6.1.3 ”UART 通 信 程 序 设计 


sP. 


将 DMA-210XP 实 验 平台 上 串 行 口 UART3 连 接 到 PC 的 串 行 口 ， 实 验 平台 的 UART3 使 用 GPA1_2 和 GPA_3 作 为 数据 线 。 编 写 Android 下 PC 与 实验 平台 UART3 的 串 行 通 信 程序 ， 并 将 结果 显示 在 LCD 屏 幕 


1.UART 界 面 设计 


在 前 一 节 设 计 出 了 驱动 程序 ， 这 一 节 主 要 介绍 如 何 设计 应 用 界面 以 进行 串 行 通信 。 具 体 步骤 如 下 。 


(1) 新 建 工程 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 


IR] 


6-4 所 示 荣 单 。 


New d 


Show In Alt+Shiftt# P 


Copy Ctrltc 
Copy Qualified Name 
Ctrlty 


Delete 


pA Export... 


dm Refresh 


6-4 + s Package Explorer? £j 4k 


2) 在 弹出 菜单 中 选择 “New” 一 “Project”， 如 图 6-5 所 示 。 


弹出 如 图 6-6 所 示 窗 口 。 


3) 选择 “Android” 一 “Android Project”， 点 击 “Next” 按 钮 。 弹 出 如 图 6-7 所 示 窗 口 ， 在 相应 位 置 填 入 信息 。 


Show In 


Copy Ctrl+C 


ES Сору Qualified Hame 
B Faste CtrltV 
MM Delete Delete 


图 6-5 ”新 建 工程 


type filter text 


(9 Class 
ў Interface 
(Ë Java Project 

| Ж Java Project from Existing Ant Buildfile 
ЫЎ Plug-in Project 

+ 25 General 


=) Android 
iS Android Project 
D Android Test Project 
oj Android XML File 
H-E cys 
+J (> Java 
* (> Plug-in Development 
+ (> User Assistance 


Ho-6 新建 工 程 窗口 


© New Android Project 


New Android Project ЕТ 
Creates а new Android Project resource. Фф 


Project name: Vart_Control| 


Contents 


(S Create new project in workspace 


O Create project from existing source 


Use default location 


O Create project from existing sample 


Samples: Apilemos 


Build Target 


Target Name 


[C] Android 1.5 
C] Google APIs 
C] Android 1.6 
[] Google APIs 


Android 2.1... 


C] Google APIs 
C] Android 2.2 
[] Google APIs 


П Android 2.3. 


[] Google APIs 


C] Android 2.3. 


[] Google APIs 
C] Android 3.0 
[] Google APIs 
E] Android 3.1 
[] Google APIs 
C] Android 3.2 
[] Google APIs 


Vendor 


Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 


Standard Android platform 1.5 
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Properties 


Application name: 


® 


图 6-7 新 建 Android 项 目 窗口 


4) 点 击 “Finish” 按 钮 完成 创 寻 


(2) 添加 图 片 资源 


在 项 目 文件 列表 中 添加 


aires | 


片 文件 ， 如 图 6-8 所 示 。 


[ 


B p drawable 


1соп. рге 


Index. Jpg 


图 6-8 ”添加 图 片 资源 


(3) 编辑 main.xml 文 件 ， 进 行 UI 设计 


xml 文 件 的 程序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<RelativeLayout 

xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:orientation-"vertical" 

android:layout widt. fill parent" 

android:layout height-"fill parent" 
android:background-"(drawable/index" 

> 

<TextView 

android: id="@+id/uart_textview" 

android:layout width-"wrap content" 

android:layout height-"wrap content" 
android:text-"DMA-210XP desk to UART item" 
android:textSize-"30px" 

android: textColor="#£ffffff£" 

android: layout_centerHorizontal="true" 

android: layout_alignParentTop="true" 

/> 

<ScrollView 

xmlns:android-"http:// schemas.android.com/apk/res/android" 
android: id="@+id/uart_scrollview" 

android: layout_width="520px" 

android: 1layout_height="230px" 

android: layout_marginTop="35px" 

android: layout_below="@+id/uart_textview" 

android: layout_alignParentRight="true" 

android: layout_marginRight="30px" 

android: background="#f£ffffff£" 

> 

<TextView 

android: id="@+id/uart_view" 

android: layout_above="@+id/uart_text" 

android: layout_widt. fill parent" 

android:layout height="fill parent" 

android: 
android: 
android: 
/> 
</ScrollView> 

<TextView 

android: id="@+id/uart_viewl" 
android: layout_width: 
android:layout heigh 
android: layout_below="@+tid/uart_scrollview" 
android: layout_centerHorizontal="true" 
android: layout_marginTop="30px" 

android: layout_marginLeft="50px" 

android: layout_marginRight="50px" 
android:text="" 

/> 

<EditText 

android: id="@+id/uart_edit" 

android: layout_width="350px" 

android: layout_height="65px" 

android: layout_marginTop=' 
android: layout_marginRight="40px" 

android: layout_below="@+id/uart_scrollview" 
android: layout_alignLeft="@+id/uart_scrollview" 
/> 

<Button 

android: id="@+id/uart_button0" 

android: layout_width="100px" 

android: layout_height="wrap_content" 

android: layout_alignTop="@+id/uart_scrollview" 
android: layout_marginLeft="70px" 
android:text="UART 3" 

/> 


<Button 

android: id="@+id/uart_button2" 

android: layout_width="100px" 

android: layout_height="wrap_content" 

android: layout_marginLeft="70px" 

android: layout _alignBottom="@+id/uart_scrollview 
android: text="CLEAN" Е 

f> 

<Button 

android: id="@+id/uart_button3" 

android: layout_width="100px" 

android:layout height-"wrap content" 

android: layout_alignBaseline="@t+tid/uart_edit" 
android: layout_marginBottom="30dip" = 
android: layout_marginLeft="70dip" 
android:text=" EXIT " 

/> 

<Spinner 

android: id="@+id/uart_mode" 

android: layout_width="100px" 

android:layout height-"wrap content" 

android: layout_below="@+id/uart_button0" 
android:layout marginTop-"l5px" 

android: layout_marginLeft="70px" 

/> 

<Button 

android: id="@+id/uart_button4" 

android:layout width-"wrap content" 
android:layout height-"wrap content" 

android: layout_alignBaseline="@t+tid/uart_edit" 
android: layout_toRightOf="@+id/uart_edit" 
android: layout_alignRight="@+tid/uart_scrollview" 
android:text-" SEND " Е 

/> 

</RelativeLayout> 


这 个 布局 文件 设计 了 四 个 按钮 、 一 个 下 拉 菜单 和 两 个 编辑 区 以 及 一 个 文本 框 ， 设 计 出 来 的 UI 如 图 6-9 所 示 。 


DMA-210XP desk to UART item 


W 


6-9 ”UART 了 驱动 界面 


(4) Uart_Controljava 程 序 代码 编写 


导入 相应 的 包 文件 : 


package tw.com.dmatek.dma210xp.uart; 

import java.util.Timer; 

import java.util.TimerTask; 

import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.AdapterView; 

import android.widget.ArrayAdapter; 

import android.widget .Button; 

import android.widget .EditText; 

import android.widget.Spinner; 

import android.widget.TextView; ikUart_Control 继承 Activity 
public class Uart_Control extends Activity { 


定义 变量 : 


TextView viewl,view2, view; 

Spinner spinnerl; 

String receiveMsg; 

String Msg, str="liwei", ReStr; 

EditText editmsg; 

Button myButton0,myButton2,myButton3,myButton4; 
private boolean signl; 

public int num-1; // 选择 那个 串 行 口 

public int fd,set,i--1,k-0; 

int p; 


private Spinner mySpinner; 


定义 下 拉 字 符 串 数 组 : 


private static final String[] countriesStr = 
( "B1200", "B2400", "В4800", 
"B9600", "В19200", "B38400", "B57600", "B115200", "B230400", "B921600"}; 


private ArrayAdapter<String> adapter; 


定义 myButton0 事 件 处 理 ， 调 用 本 地 方法 打开 串 行 口 ， 设 置 串 行 传输 速率 : 


private Button.OnClickListener myButton0_listener=new 
Button.OnClickListener () 


{ 

public void onClick(View arg0) { 
// TODO Auto-generated method stub 
if (i>0) 

{ 

Linuxc.closeUart (0); 

} 

і=1; 

fd=Linuxc.openUart (3); 

if (fd>0) 


setTitle ("open device sucess!"+String.valueOf (fd) ) 7 
Linuxc.setUart (К); 

signl-true; 

} 

else 


setTitle ("open device false!"+fd); 
signl-false; 

} 

viewl.setText ("The current UART: 3"); 
l 

1; 


定义 myButton2 事 件 处 理 ， 清 空 字符 串 编辑 框 : 


private Button.OnClickListener myButton2_listener=new 
Button.OnClickListener () 


public void onClick(View v) { 

// TODO Auto-generated method stub 
view.setText (null); 

} 

1; 


定义 myButton3 事 件 处 理 ， 关 闭 串 行 | 


private Button.OnClickListener myButton3_listener=new 
Button.OnClickListener () 

{ 

public void onClick(View v) { 

// TODO Auto-generated method stub 

timer.cancel(); 

Linuxc.closeUart (0) ; 

finish(); 

} 

1; 


定义 myButton4 事 件 处 理 ， 调 用 本 地 方法 发 送 串 行 端 口 数据 : 


private Button.OnClickListener myButton4 listener-new 
Button.OnClickListener () 

{ 

public void onClick(View v) { 

// TODO Auto-generated method stub 
Msg=editmsg.getText () .toString(); 

Linuxc.sendMsgUart (Msg) ; 

} 

1; 


定义 时 间 线程 ， 通 过 调用 本 地 方法 不 断 接收 数据 : 


Timer timer = new Timer(); 

/* 新 建 一 个 定时 器 任务 task */ 
TimerTask task = new TimerTask() { 
public void run() { 
runOnUiThread (new Runnable() ( 
public void run() { 

if (signl) { 
ReStr-Linuxc.receiveMsgUart (); 
if (ReStr!-null) 

{ 

view.append (ReStr) ; 
view.append("\n") ; 

ReStr-null; 

l 


Ë 
} 
n; 
} 
} 


构 onDestroy 方 法 ， 关 闭 串 行 口 和 释放 资 


GOverride 
public void onDestroy() 


{ 

signl-false; 
timer.cancel(); 
Linuxc.closeUart (0); 
finish(); 

} 


实现 程序 第 一 次 启动 时 调用 的 方法 onCreate: 


GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


显示 布局 文件 : 


setContentView (R.layout.main) ; 


时 间 线程 调度 : 


timer.schedule(task, 1000, 10); 


获取 资源 ID， 实 例 化 变量 ， 设 置 编辑 框 宽 度 : 


mySpinner- (Spinner) findViewById (R.id.uart mode); 
viewl- (TextView) findViewById(R.id.uart textview); 
view- (TextView) findViewById (R.id.uart view); 
editmsg- (EditText) findViewById (R.id.uart edit); 
editmsg.setWidth (200); 

myButton0- (Button) findViewById (R.id.uart button0) 
myButton2- (Button) findViewById (R.id.uart button2) 
myButton3- (Button) findViewById (R.id.uart button3) 
myButton4- (Button) findViewById (R.id.uart button4) 


为 组 件 设置 监听 事件 : 


myButton0.setOnClickListener (myButton0_listener) ; 
myButton2.setOnClickListener (myButton2_listener) ; 
myButton3.setOnClickListener (myButton3_listener) ; 
myButton4.setOnClickListener (myButton4 listener); 


实例 化 字符 串 适 配器 : 


adapter = new ArrayAdapter<String> (this, 
android.R.layout.simple spinner item, countriesStr) ; 


mySpinner 绑 定 适 配器 : 


adapter.setDropDownViewResource (android.R.layout.simple_spinner_ 
dropdown_item) ; 
mySpinner.setAdapter (adapter) ; 


mySpinner 的 OnltemselectedListener 事 件 监听 ， 调 用 本 地 方法 设置 串 行 口 串 行 传输 速率 : 


mySpinner.setOnItemSelectedListener (new 

Spinner .OnItemSelectedListener () 

{ 

public void onItemSelected (AdapterView<> arg0, View argl, int arg2, 
long arg3) 

{ 


if(fd>0) Linuxc.setUart (arg2) ; 

k=arg2; 

arg0.setVisibility (View.VISIBLE) ; 

} 

public void onNothingSelected (AdapterView<> arg0) 


{ 

// TODO Auto-generated method stub 
} 

D; 


} 


(5) 添加 JNI 函 数 本 地 方法 定义 的 Java 程 序 


右 击 项 目 图 标 ， 在 弹出 菜单 中 点 击 “New” 一 “Class”， 如 图 6-10 所 示 。 


Open Type Hierarchy F4 
Show In 


图 6-10 新建 一 个 类 


弹出 如 图 6-11 所 示 界 面 。 


填写 相应 信息 后 ， 点 击 “Finish” 按 钮 完成 创建 。 


编辑 Linuxc 这 个 Java 文 件 。 这 是 一 个 定义 了 本 地 方法 的 Java 类 ， 并 调用 SO 库 。 程 序 代码 如 下 所 示 : 


package tw.com.dmatek.dma210xp.uart; 
import android.util.Log; 


public class Linuxc { 

static 

{ 

try 

{ 

System. loadLibrary ("uart") ; 

Log.i("JIN", "Trying to load libuart.so"); 


catch (UnsatisfiedLinkError ule) 


{ 
Log.e("JIN", "WARNING: could not load libuart.so"); 
} 


public static native int openUart (int i); 

public static native void closeUart (int i); 
public static native int setUart (int i); 

public static native int sendMsgUart (String msg) ; 
public static native String receiveMsgUart (); 

} 


通过 设计 底层 方法 来 实现 对 驱动 的 调用 。 若 已 有 使 用 事先 编译 的 SO 函数 库 及 JNI 函 数 ， 或 自行 编译 的 动态 链接 库 ， 首 先 将 libs\armeabiNlibuart.so 这 个 文件 拷贝 到 项 目 目录 下 ， 如 图 6-12 所 示 。 请 注意 
路 径 必须 维持 为 libs\armeabiNlibuart.so。 


© Wer Java Class 
Java Class 


Create a rev Java class. 


cota: EEN т 


Modi fi ers: (public CJ defan t rivate Protected 
[ ]abstraet [ | final stati 


superclass: | java. lang. Object | Browse. . 
Interfaces: | Add... 


Кепе 


Which method stabs would you like to create? 
| |public static void main (Siring[] ares) 


[ |constructors fron superclass 
[v] Inherited abstract methods 


De you want to add comments? (Configure tanplates and default valua harel 
[| |Generate connents 


图 6-11 填写 类 名 


2; 


dr SE G) rae) who ИЕ 


Hi o i Ü:*apk workspace) Use t Сотко 


libuari. sc 


Te PERDERE XC EESE x "": 


图 6-12 添加 SO 函数 库 
(6) 刷新 项 目 ， 添 加 编译 出 来 的 SO 中 间 库 文件 


选择 项 目 ， 按 F5 键 刷新 项 目 ， 如 图 6-13 所 示 。 


刷新 后 ， 工 程 中 的 SO 文件 如 图 6-14 所 示 。 
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6-13 ”刷新 工程 
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图 6-14 ”查看 工程 中 的 SO 


(7) 生成 APK 
6-15 所 示 。 


此 当 把 SO 复制 到 项 目 目录 下 时 ， 它 也 已 经 编译 完成 了 。 生 成 的 APK 在 项 目 目录 的 bin 目 录 下 。 如 图 


由 于 Eclipse 可 以 设 定 自动 编译 功能 ， 因 


Cr .apk workspace), Uart_Control bin 


TEMERS 3 ix E us 


EERE : | m. PES apo | е eae ak 
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16-15 “生成 APK 
到 此 ， 串 行 端口 控制 程序 设计 就 完成 了 。 
2.UART JNI 设 计 
(1) 生成 C 语 言 头 的 Java 文 件 
将 Uart_Control 工 程 拷 贝 到 读者 的 工作 目录 下 ， 工 作 目 录 为 CNapk_workspace\Uart_ Control。 


(2) 编译 Java 文 件 成 C 语 言 的 头 文件 
1) 在 “开始 ”菜单 中 点 击 “ 运 行 ”， 然 后 输入 “cmd” 进 入 DOS 命 令 提 示 符 窗口 ， 如 图 6-16 所 示 。 


j7] Ер ЛЕР. ЭЕ, PSR Internet ЎН 


Hio Windows HEF E a 


HF 0): 


图 6-16 启动 DOS 


2) 进入 CNapk_workspace\Uart_Control 目 录 下 ， 如 图 6-17 所 示 。 


3) 建立 一 个 名 称 为 jni 的 目录 ， 然 后 进入 jni 目 录 ， 如 图 6-18 所 示 。 


jni 这 个 目录 用 于 存放 C 及 C++ 原始 程序 代码 文件 ， 以 及 要 编译 这 些 程序 代码 的 脚本 文件 。 


4) 执行 命令 “javah-classpath “C:\apk_workspace\Uart_Control\bin" tw.com.dmatek.dma210xp.uart.Linuxc" , 


: apk_works pace \BackLight_Control\jni?cd CG:\apk_vorkspace Марке __ Control 


: \apk_workspace Wart Contro l> m 


6-17  3tAUart. Control 142 B Ж 


C: \арк_ vorkspace Mart Control»md jni 


C: vapk workspace Wart_Control>cd jni 


C:\apk_works расе Wart_Control\jni>, 


图 6-18 ”进入 Uart_Conttrol 目 录 创 建 jni 目 录 


如 图 6-19 所 示 ， 在 当前 目录 jni 下 生成 一 个 tw_com_dmatek_dma210xp_uart_Linxuc.h 文 件 。 


RDO¥S\ syst em32\ cad. exe 


С: Харк workspace Wart _Control\jni>javah -classpath ‘C:\apk workspace 
NJart Control*bin" tu.con.dmatek.dma2108xp.uart.Linuxc 


vb de ep _Control\jni>dir 
Whales C HANGE SYSTEM 


类 的 序列 号 22 o982C-?58B 


C:\apk_workspace Wart_Control\jni ABF 


911-10-14 69:40 <DIR> - 
0811-18-14 09:49 <DIR> А 
2911-18-14 rios 1.409 tv -gom. ian tal _dma2i@xp_uart_Linuxc .h 
jt 文件 1.499 545 
个 目录 65.098,428,416 可 用 字 节 


C: \apk_workspace Wart_Control\jni>, 


86-19 ” 饶 看 jni 目 录 中 的 文件 


(3) 编写 调用 C 语 言 头 的 文件 C 程 序 代码 


C 程 序 代码 创 建 一 个 tw_com_dmatek_dma210xp_uart_Linuxc.c 文 件 ， 实 现 tw_com_dmatek_dma210xp_uart_Linuxc.h 这 个 头 文件 中 定义 的 函数 ， 其 程序 码 如 下 。 


定义 头 文件 : 


#include <stdio.h> 
#include <stdlib.h> 
#include «fcntl.h» 
#include <errno.h> 
#include <unistd.h> 
#include "tw_com_dmatek_dma210xp_uart_Linuxc.h" 
#include <sys/types.h> 
#include <sys/stat.h> 
#include <string.h> 
#include <stdint.h> 
finclude <termios.h> 
#include <android/log.h> 
#include <sys/ioctl.h> 
#undef TCSAFLUSH 

#define TCSAFLUSH TCSETSF 
#ifndef TERMIOS H_ 
#define TERMIOS Н 
dendif ` == 


定义 全 局 变量 


int fd; 
struct termios newtio,oldtio; 


实现 本 地 方法 openUart: 


JNIEXPORT jint JNICALL 
Java_tw_com_dmatek_dma210xp_uart_Linuxc_openUart 
(JNIEnv ` *env, jobject mc,jint i) 


{ 
if (i==1) 


{ 
fd-open ("/dev/ttySACl",O RDWR|O NOCTTY|O NDELAY);// ©_NOCTTY 
return fd; 


] 

else if (i==2) { 

fd-open("/dev/ttySAC2",O RDWR|O NOCTTY|O NDELAY); 
return fd; 


else if (i==3) 

fd=open (" pra) O RDWR|O NDELAY|O NOCTTY); 
return fd; 

} 

return fd; 


实现 本 地 方法 closeUart: 


JNIEXPORT void JNICALL 
Java tw com dmatek dma210xp uart Linuxc closeUart (JNIEnv 
*env, jobject mc,jint i) 


{ 
close (Ёа); 
l 


实现 本 地 方法 setUart: 


JNIEXPORT jint JNICALL 
Java_tw_com_dmatek_dma210xp_uart_Linuxc_setUart (JNIEnv *env, jobject 
mc,jint i) 


int 
speed arr[]-(B1200,B2400,B4800, B9600, B19200, B38400, B57600, B115 
200, B230400, B921600) ; 


tcgetattr (fd, &oldtio); 

tcgetattr (fd, &newtio); 

cfsetispeed(&newtio,speed arr[i]); 

cfsetospeed (&newtio, speed arr[il); 

/* newtio.c lflag &= ~ (ІСАМОМ | ЕСНО |ЕСНОЕ | ISIG) ; // 定义 原始 模式 
newtio.c oflag &= -OPOST; // 可 以 收 到 完整 的 数据 , 包括 不 可 打印 字符 与 大 于 128 的 字符 
newtio.c iflag &- ~(BRKINT | ICRNL | INPCK | IXON | ISTRIP ) ; 

newtio.c cflag |= CS8; 

newtio.c cc[VTIME] = 1; // 定义 等 待 时 间 
newtio.c_cc[VMIN] = 1 
x 

newtio.c lflag-0 
newtio.c cflag speed arr[i] | CS8 | CREAD | CLOCAL; 

newtio.c iflag- BRKINT | IGNPAR | IGNCR | IXON | IXOFF | IXANY ; 
newtio.c oflag-02; 

newtio.c line 
newtio.c cc[7 
newtio.c cc[4]-0; 
newtio.c сс[5]=0; 
Де E 
newtio.c lflag-0; 
newtio.c cflag B115200 | CS8 | CREAD | CLOCAL; 
newtio.c iflag- INPCK; 

newtio.c oflag-02; 

newtio.c line-0; 

// newtio.c cc[7]-255; 

newtio.c cc[4]-1; 

newtio.c cc[5]-0; 

НА 

if (tcsetattr (fd, TCSANOW, &newtio) <0) 

{ 

printf ("tcsetattr fail !\n"); 

exit (1); 

} 

return fd; 


} 


实现 本 地 方法 sendMsgUart: 


JNIEXPORT jint JNICALL 
Java tw com dmatek dma210xp uart Linuxc sendMsgUart (JNIEnv 
*env, jobject mc,jstring str) 


int len; 

const char *buf; 

buf=(*env) -»GetStringUTFChars (env, str, NULL) ; 
len= (*env)->GetStringLength (env, str ); 
write (fd, buf, len) ; 

(*env) ->ReleaseStringUTFChars (env, str, buf); 
} 


实现 本 地 方法 receiveMsgUart: 


JNIEXPORT jstring JNICALL 
Java_tw_com_dmatek_dma210xp_uart_Linuxc_receiveMsgUart (JNIEnv 
*env, jobject mc) 


char buffer[255]; 
char buf [255]; 
int len, i=0,k=0; 
memset (buffer, 0, sizeof (buffer) ) ; 
memset (buf, 0, sizeof (buf) ); 
printf ("Nn"); 
len=read (fd, buffer, 255); 
if (len»0) 
{ 
android_log print (ANDROID LOG INFO,"len","len =%d, 
buffer [0]=%c, buffer [1] =%с\п", len, buffer [0] , buffer [1]) ; 
__android_log_print (ANDROID LOG INFO, "buffer", "buffer=%s\n", buff 
er); 
// return (*env)-»NewStringUTF (env, buffer) ; 
} 
е1ве 
return NULL; 
} 


(4) 创建 生成 SO 的 配置 文件 


现在 jni 目 录 下 已 经 有 tw_com_dmatek_dma210xp_led_Linuxc.h 和 tw_com_dmatek_dma210xp_led_Linuxc.c 这 两 个 文件 。 还 需要 添加 一 个 脚本 文件 实现 编译 链接 ， 其 文件 名 为 Android.mk， 其 代码 
如 下 : 


LOCAL PATH := $ (call my-dir) 

include $ (CLEAR VARS) 

LOCAL MODULE := uart 

LOCAL SRC FILES := tw com dmatek dma210xp uart Linuxc.c 
include $(BUILD SHARED LIBRARY) 


(5) 生成 SO 动态 链接 库 


打开 Cygwin 终 端 ， 进 入 CNapk_workspace\Uart_Control 目 录 ， 然 后 执行 “ndk-build” 命 令 即 可 。 如 图 6-20 所 示 ， 人 生成 需要 的 动态 链接 库 SO。 


ndk-build 


/cyugqdrive/c 


cd apk_workspace/Uart_Control 


“eygdrivec/Hapk_workspacc/“Uart_Control 


ompile thumb uart <= tw_com_dmatek_dmaZ14xp_uart_Linuxce .c 


6.1.4 ПАКТ РЕЛ, 


SharedLibrary libuart.so 


libuart.so => libs/armeahi/libuart.so 


/cygdriue/c/apk workspace/llart Control 


6-20 ”生成 动态 链接 库 


测试 自己 编写 的 UART 程 序 ， 步 骤 如 下 : 


1) 打开 DMA-210XP 平 台 的 电源 ， 启 动 系统 。 


2) 安装 好 应 用 程序 。 

3) 启动 程序 。 

串 行 口 的 测试 需要 一 个 具有 串 行 端口 的 PC 主机 ， 将 PC 的 串 行 口 使 用 串 行 线 连接 到 DMA-210XP 平 台 上 。 打 开 应 用 程序 ， 如 图 6-21 所 示 。 

点 击 UART3 下 的 “B1200” 安 装 设置 波 特 率 为 115200， 点 击 “UART3” 按 钮 ， 打 开 串 行 端口 。 

可 以 发 现 打 开 串 行 端口 成 功 的 信息 ， 可 以 在 SEND 旁 边 的 文本 框 中 输入 要 发 送 的 信息 ， 点 击 “SEND” 按 钮 发 送 这 个 信息 即 可 ， 如 图 6-22 所 示 。 


图 6-21 串 行 端口 应 用 程序 启动 界面 


The current UART : 3 


6-22 发 送信 息 


如 果 在 PC 端 发 送信 息 ， 在 文本 域 中 可 以 看 到 结果 ， 如 图 6-23 所 示 。 


在 DMA-210XP 实 验 平台 上 接收 到 信息 ， 如 图 6-24 所 示 。 
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图 6-23 ”PC 端 发 送信 息 
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61 UART 串 行 接口 及 通信 程序 


6.1.1 UARTÍS fT 


The current UART : 3 


96-24 DMA-210XP 实 验 平台 接收 的 信息 


S5PV210 的 通用 异步 接收 /发 送 装 置 (UART) 提供 了 四 个 独立 的 异步 串 行 输入 /输出 (1/0) 端口 。 所 有 端口 都 运行 在 中 断 或 DMA 模 式 下 。UART 控 制 器 可 以 在 CPU 和 UART 之 间 产 生 一 个 中 断 或 者 DMA 
请 求 来 传输 数据 。UART 支 持 的 比特 率 最 高 可 达 3Mbps。 每 个 UART 通 道 包含 两 个 FIFO 负 责 接收 和 发 送 数据 : 56 字 节 的 CH0，64 字 节 的 CH1 和 16 字 节 的 CH 和 CH3。 


UART 包 含 可 编程 的 波 特 率 ， 红 外 接收 /发 送 ， 插 入 一 个 或 两 个 停止 位 ，4~ 8 位 数据 宽度 和 奇偶 校 


б 


每 个 UART 包 括 一 个 波 特 率 发 生 器 、 一 个 发 送 器 、 一 个 接收 器 和 一 个 控制 单元 。 波 特 率 发 生 器 的 输入 可 以 是 PCLK 或 者 UEXTCLK。 发 送 器 和 接收 器 包含 FIFO 和 移 位 寄存 器 ， 数 据 被 送 入 Tx FIFO, Mas 
制 到 发 送 移 位 寄存 器 ， 然 后 数据 按 位 从 发 送 数据 引 脚 TxDn 输 出 。 同 时 ， 从 引 脚 RxDn 接 收 数据 发 送 到 移 位 寄存 器 ， 并 复制 到 Rx FIFO. 


1.UART 接 口 特性 


UART 接 口 的 特性 如 下 所 示 : 


: RXD0、TXD0、RXD1、TXD1、RxD2、TxD2、RXD3 和 TXD3 具 有 基于 DMA 或 基于 中 断 的 操作 。 


: UART 通 道 0、1、2、3 具 有 IDA1.0。 


- UART 通 道 0 具 有 256 字 节 的 FIFO ， 通 道 1 具 有 64 字 节 的 FIFO ， 通 道 2 和 3 具有 16 字 节 的 FIFO。 


+ UART 通 道 0、1 和 2 具有 nRTS0、nCTS0、nRTS1、nCTS1、nCTS2 和 nRTS2 自 动 流 控制 。 


+ 支持 握手 的 发 送 / 


UART 的 结构 框图 如 


接收 。 


图 6-1 所 示 。 
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2.UART 操 作 


下 面 介 绍 UART 的 操作 ， 包 括 数据 传输 、 数 据 接收 、 中 断 产生 、 波 特 率 产生 、 环 回 


(1) 数据 发 送 


发 送 缓冲 寄存 器 
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16-1 UART 结 构 框 图 
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本 模式 、 红 外 线 模式 和 自动 流量 控制 。 


发 送 FIFO 寄 zx 
(FIFO 模式 ) 


` AE ASAE Hit 
C JEFIFOF: zÜ ) 


收 保存 寄存 天 
( 非 PIFO 模 ist ) 


zy "IF 寄存 i 


( FIFOJX ) 


TXDn 


RXDn 


Let AESHMEFIFOSEÉERR , АГЕР 
п HELE 存 寄 存 需 


数据 帧 发 送 是 可 编程 的 。 它 由 一 个 起 始 位 、5~8 个 数据 位 、 一 个 可 选 的 奇偶 位 和 1~2 个 可 由 行 控制 寄存 器 (ULCONn) 指定 的 停止 位 组 成 。 发 送 器 也 可 以 产生 中 断 条 件 ， 在 传输 过 程 中 ， 它 通过 置 位 逻 
辑 状态 0 来 强制 串 行 输出 。 当 目前 的 发 送 完全 传输 完成 后 ， 发 送 中 断 信 号。 然后 不 断 传送 数据 到 发 送 FIFO 寄 存 器 (在 非 FIFO 的 模式 下 ， 发 送 保存 寄存 器 ) 。 


(2) 数据 接收 


和 数据 发 送 一 样 ， 数 据 帧 接收 也 是 可 编程 的 。 它 由 一 个 起 始 位 、5~8 个 数 拉 
件 ， 并 为 它们 设置 错误 标志 。 溢 出 错误 说 明 在 读 取 数据 之 前 ， 新 的 数 


居 位 、 一 个 可 选 的 奇偶 位 和 行 控制 寄存 器 指定 
居 已 经 覆盖 原 有 的 数据 。 奇 偶 错误 说 明 接收 器 已 经 检 疯 


的 1~2 个 停止 位 组 成 。 接 收 器 可 以 检测 到 溢出 错误 、 奇 偶 错误 、 帧 错误 和 中 断 条 
一 个 意外 的 奇偶 条 件 。 帧 错误 表示 收 到 的 数据 


居 没 有 有 效 的 停止 位 。 中 断 条 件 表 


了 明 接 收 过 程 中 置 位 逻辑 状态 0 的 时 间 比 发 送 一 帧 的 时 间 长 。 当 三 个 字 的 时 间 (间隔 由 设置 的 字 长 决定 ) 间隔 内 没有 接收 任何 数据 ， 并 且 FIFO 模 式 下 接收 FIFO 寄 存 器 不 为 空 ， 产 生 接收 超时 条 件 。 


(3) 自动 流量 控制 


UART0 和 UART1 通 过 nRTS 和 mnCTS 信 号 支持 自动 流量 控制 (AFC 


位 ， 并 且 通 过 软件 控制 信号 nRTS。 在 自动 流量 控制 过 程 中 ，nRTS 依 靠 接收 器 的 条 件 ，nCTS 信 号 控制 发 送 器 的 运作 。 


йв) ，UART 的 发 送 器 发 送 FIFO 寄 存 器 中 的 数据 。 在 UART 接 收 数据 之 前 ， 如 果 它 接收 FIFO 寄 存 器 超过 两 个 字 : 


止 活动 (在 AFC 中 ，nRTS 表 示 自 己 的 FIFO 寄 存 器 准备 接收 数据 ) 。 图 


。 某 种 情况 下 ， 它 可 以 连接 到 外 部 UART。 如 果 想 要 将 UART 和 一 台 调 制 解 调 器 连接 ， 必 须 在 UMCONn 寄 存 器 中 禁用 自动 流量 控制 
只 有 激活 nCTS 信 号 (在 AFC 中 ，nCTS 表 示 另 一 个 UART 的 FIFO 寄 存 器 准备 接收 数 

节 以 上 的 空间 ， 则 激活 nRTS; 如 果 它 的 接收 FIFO 寄 存 器 只 有 不 足 一 个 字 节 的 空间 ，nRTS 则 停 
6-2 显 示 了 UARTAFC 接 口 的 发 送 和 接收 状态 图 。 
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6-2 ПАКТАЕС о 


非 自动 流量 控制 的 例子 ， 如 通过 软件 控制 NRTS 和 NCTS。 
(4) 接收 FIFO 的 操作 
Т) 选择 接收 模式 (中断 或 DMA 模 式 ) 。 


2 


3) 重复 步骤 2。 
(5) 发 送 FIFO 的 操作 
Т) 选择 发 送 模式 (中断 或 DMA 模 式 ) 。 


2 


检查 UMSTATn[0] 的 值 ， 如 果 这 个 值 是 1 (激活 nCTS) ， 则 写 数 据 到 发 送 FIFO 寄 存 器 。 


3) 重复 步骤 2。 


(6) RS-232C 接 口 


在 UFSTATn 中 查看 RXFIFO 计 数 器 的 值 。 如 果 该 值 小 于 15， 必 须 设置 UMCONn[0] 值 为 1 (激活 nRTS) ; 如 果 该 值 等 于 或 大 于 15， 必 须 先 设 定 UMCONn[0] 值 为 0 (停止 RTS) 。 


要 将 UART 连 接 到 调制 解 调 器 接口 (而 不 是 零 调制 解 调 器 ) ， 需 要 nRTS、nCTS、nDSR、nDTR、DCD 和 nmnRI 信 号 。 在 这 种 情况 下 ， 可 以 通过 软件 来 控制 这 些 信号 与 一 般 的 MO 端口 。 因 为 AFC 不 支持 RS- 


232C 接 口 。 


(7) 中 断 /DMA 请 求 的 产生 


S5PV210 中 每 个 UART 有 7 个 状态 (Tx/Rx/Error) 信和 号: 溢出 错误 、 奇 偶 错误 、 帧 错误 、 中 断 、 接 收 缓冲 器 满 、 发 送 缓冲 器 空 和 发 送 移 位 寡 存 器 空 。 这 些 状态 体现 在 UART 状 态 寄存 器 中 的 相关 位 


(UTRSTATn/UERSTATn) 。 


溢出 错误 、 奇 偶 错误 、 帧 错误 和 中 断 条 件 与 接收 错误 状态 相关 ， 如 果 控 制 寄 存 器 UCONn 中 的 receive-error-status-interrupt-enable 位 被 置 1 的 话 ， 每 个 错误 可 以 产生 一 个 接收 错误 状态 中 断 请 求 。 如 


果 探 测 到 一 个 receive-error-status-interrupt-enable 位 ， 通 过 读 UERSTATn 的 值 可 以 识别 这 一 中 断 请 求 。 


在 FIFO 模 式 中 ， 如 果 FIFO 寄 存 器 接收 到 移 位 寄存 器 传送 数据 发 送 的 数据 大 于 或 等 于 Rx FIFO 触 发 电 平 ， 
FIFO 的 中 断 请 求 和 轮 询 模式 中 ， 保 持 寄存 器 接收 到 移 位 寄存 器 传输 的 数据 将 产生 Rx 中 上 断 。 


接收 模式 控制 寄存 器 (UCONN) 被 设置 为 1 (中 断 请 求 或 轮 询 模式 ) ， 则 产生 Rx 中 断 。 在 非 


如 果 发 送 器 从 其 发 送 FIFO 寄 存 器 传送 数据 到 发 送 移 位 器 和 对 数 的 数据 留 在 发 送 FIFO 小 于 或 等 于 Tx FIFO 中 的 触发 电 平 ， 将 产生 Tx 中 断 (依靠 发 送 模式 选择 控制 寄存 器 的 中 断 请 求 或 轮 询 模式 ) 。 非 FIFO 


模式 下 的 中 断 请 求 和 轮 询 模式 ， 移 位 寄存 器 接收 到 发 送 保持 寄存 器 传输 数据 将 产生 Tx 中 断 。 


注意 : 如 果 发 送 的 FIFO 中 的 数据 小 于 触发 电 平 总 是 产生 Tx 中 断 。 这 意味 着 除非 填写 Tx 缓冲 区 ， 否 则 一 有 中 断 请 求 将 产生 Tx 中 断 。 建 议 先 填写 Tx 缓冲 区 ， 然 后 启用 Tx 中 断 。 


S5PV210 的 中 断 控制 器 是 电 平 触发 型 。 如 果 对 UART 控 制 寄存 器 编程 必须 设置 中 断 类 型 为 “ 电 平 ”。 


如 果 控 制 寄存 器 的 接收 和 发 送 模式 被 选择 为 DMAn 请 求 模式 ， 那 么 在 上 述 情况 下 MAn 请 求 将 代替 Rx 或 Tx 中 断 发 生 ， 如 表 6-1 所 示 。 


表 6-1 与 FIFO 相 连 的 中 断 


如 果 Rx FIFO 计数 高 于 或 等 于 接收 FIFO ff) foh 
发 电 平 则 产生 中 断 。 如 果 FIFO 中 数据 未 达到 Rx 
FIFO 触发 电 平 并 且 在 3 个 时 间 周 期 内 (接收 超时 ) 
将 产生 中 断 。 时 间 周 期 由 字 长 bit 设 定 


接收 缓冲 区 已 满 将 由 接收 保持 寄存 器 产生 中 断 。 
如 果 Rx FIFO 计数 高 于 或 等 于 接收 FIFO 的 触发 电 
平 则 产生 中 断 。 如 果 FIFO 中 数据 未 达到 Rx FIFO 
触发 电 平 并 且 在 3 个 时 间 周 期 内 (接收 超时 ) 将 产 
生 中 断 。 时 间 周 期 由 字 长 bit 设 定 

如 果 Tx FIFO 计数 低 于 或 等 于 发 送 FIFO 出 发 电 | ” 当 发 送 缓冲 区 的 数据 变 为 空 ， 发 送 保持 寄存 器 产 
P (Tx FIFO 触发 电 平 ) 则 产生 中 断 生 一 个 中 断 

当 溢 出 错误 、 奇 偶 错误 、 帧 错误 、 中 断 信 号 被 检 
测 到 时 产生 


接受 中 断 


发 送 中 断 


错误 中 断 如 果 同 时 发 生 多 个 错误 ， 则 只 产生 一 个 中 断 


(8) UART 错 误 状态 FIFO 


除了 Rx FIFO 寄 存 器 之 外 ，UART 还 具有 一 个 错误 状态 FIFO。 错 误 状 态 FIFO 表 示 了 在 FIFO 寄 存 器 中 ， 哪 一 个 数据 在 接收 时 出 错 ， 错 误 中 断 发 生 在 读 取 有 错误 的 数据 时 。 为 清除 错误 状态 FIFO， 需 要 读 取 
寡 存 器 URXHn 和 UERSTATn。 


例如 : 假设 UART 的 Rx FIFO 连 续 接收 到 A、B、C、D 字 符 ， 并 且 在 接收 8B 字符 时 发 生 了 帧 错误 ( 即 该 字符 没有 停止 位 ) ， 在 接收 D 字 符 时 发 生 了 奇偶 校 验 错 。 虽 然 UART 错 误 发 生 了 ， 但 是 不 会 产生 错误 
中 断 ， 因 为 含有 错误 的 字符 还 没有 被 CPU 读 取 。 


(9) 红外 线 (IR) 模式 

S5PV2100 的 UART 模 块 支持 红外 线 (IR) 发 送 和 接收 ， 可 以 通过 设置 UART 控 制 寄存 器 (ULCONn) 中 的 红外 模式 位 来 选择 这 一 模式 。 
3.UART 专 用 寄存 器 

(1) UART 行 控制 寄存 器 

UART 模 块 中 有 四 个 UART 线 控制 寄存 器 : ULCON0、ULCON1、ULCON2 和 ULCON3， 如 表 6-2 所 示 。 

* ULCONO, R/W, Address-OxE90 0000 

< ULCONI, R/W, Address-OxE90 0400 

* ULCON2, R/W, Address=0xE90_0800 

< ULCON3, R/W, Address=0xE90_0C00 


Ж6-2 UART 行 控制 寄存 器 


位 名 称 初始 状态 

确定 是 否 采用 红外 模式 : 

Infra-Red Mode 0= 普 通 操作 模式 0 

1= 红外 线 输出 /接收 模式 

在 UART 发 送 /接收 操作 过 程 中 确定 奇偶 产生 类 型 和 校 验 : 

0xx = 无 校 验 

100 = 奇 校 验 

101 = 偶 校 验 

110 = 奇偶 强制 / 校 验 为 1 

111 = 奇偶 强制 / 校 验 为 0 

确定 每 帧 中 停止 位 个 数 : 

Number of Stop Bit 0 = fidt 1 位 停止 位 0 
1 = fiit 2 位 停止 位 
确定 每 帧 中 数据 位 个 数 : 

Word Length 00=5 位 01=6 位 00 
10=7 位 11=8 位 


Parity Mode 000 


(2) UART 控 制 寄存 器 
UART 模 块 中 有 四 个 UART 控 制 寄 存 器 : UCON0、UCON1、UCON2 和 ULCON3， 如 表 6-3 所 示 。 


: UCONO, R/W, Address=0xE90_0004 


<- UCON1, R/W, Address=0xE90_0404 
: UCON2, R/W, Address=0xE90_0804 
- UCON3, R/W, Address=0xE90_0C04 


6-3 UART 控 制 寄存 器 


Tx DMA 脉冲 Tx DMA 传输 尺寸 


20 
Size [20] 0= 1 byte (Яй), 1= 4 byte 


(Ж) 


> 


Rx DMA 脉冲 Rx DMA 传输 尺寸 
. [16] N 0 
Size 0 = 1 byte Jti), 1—4 byte 
Reserved 保留 0000 
. 从 时 钟 控 制 器 选择 PCLK 或 SCLK_UART 作为 UART 的 波 特 率 
Clock Selection [10] 00 
0=PCLK: DIV VALI )=(PCLK /(bps x 16) )-1 
中 断 请 求 类 型 
Tx Interrupt Type [9] 0= 脉冲 0 
1= 电 平 
中 断 请 求 类 型 
Rx Interrupt Type [8] 0= 脉冲 0 
1= 电 平 
Rx Time Out я UART FIFO 有 效 时 Rx 超时 中 断 使 能 ， 此 中 断 是 一 个 接收 中 断 
Enable 7 0= 失效，1 = 有 效 
在 接收 操作 中 出 现 中 断 、 帧 错误 、 奇 偶 错 误 或 溢出 错误 ，UART 
Rx Error Status 6 产生 异常 中 断 使 能 0 
Interrupt Enable [e] 0 = 接收 错误 状态 不 产生 中 断 


1 = 接收 错误 状态 产生 中 断 
设置 UART 的 loop-back bit 为 1 进入 回环 模式 ， 此 模式 只 用 于 
Loop-back Mode [5] 测试 0 
0 = 普通 模式 ，1 = 回环 模式 
在 一 个 帧 时 间 内 设置 UART， 该 位 将 发 送 中 断 信号 。 发 送 中 断 
Send Break Signal [4] 言 号 后 改 为 自动 清除 0 
0= 正常 发 送 ，1 = 发 送 中 断 信 和 号 
决定 以 哪 种 方式 将 Tx 的 数据 写 人 UART 发 送 缓冲 寄存 器 
00= 失效 01 = 中 断 请 求 或 轮 询 模式 00 
10=DMA BEX, П = 保留 
决定 以 哪 种 方式 读 人 UART 接收 缓冲 寄存 器 的 数据 
00 — 失效 01 = 中 断 请 求 或 轮 询 模 式 00 
10= ОМА #5, П = 保留 


Transmit Mode [3:2] 


Receive Mode [1:0] 


(3) UART 的 FIFO 控 制 寄存 器 
UART 模 块 中 有 四 个 UART FIFO 控 制 寄存 器 : UFCONO、UFCON1、UFCON2 和 UFCON3， 如 表 6-4 所 示 。 
: UFCONO, R/W, Address=0xE90_0008 


- UFCON1, R/W, Address=0xE90_0408 


+ UFCON2, R/W, Address=0xE90_0808 


: UFCON3, R/W, Address=0xE90_0C08 


fr 名 称 


Reserved 


Tx FIFO Trigger Level 


Reserved 


Rx FIFO Trigger Level 


Reserved 


Tx FIFO Reset 


Rx FIFO Reset 


FIFO Enable 


确定 Tx FIFO 的 触发 电 平 。 如 果 Tx FIFO 数据 计数 小 于 
或 等 于 触发 电 平 ， 将 产生 Tx 中 断 


[7] 


[6:4] 


(4) UART 接 收 (Rx) / (Tx) 发 送 状态 寄存 器 


表 6-4 UART 的 FIFO 控 制 寄存 器 


[通道 0] 
000 = 0 byte 
010 = 64 bytes 
100 = 128 bytes 
110 = 192 bytes 
[通道 1] 
000 = 0 byte 
010 = 16 bytes 
100 = 32 bytes 
110 = 48 bytes 
[ 通道 3] 
000 = 0 byte 
010 = 4 bytes 
100 = 8 bytes 
110 = 12 bytes 


[ 通道 0] 

000 = 32 bytes 
010 = 96 bytes 
100 = 160 bytes 
110 = 224 bytes 
[ 通道 1] 

000 = 8 bytes 
010 = 24 bytes 
100 = 40 bytes 
110 = 56 bytes 
[ 通道 3] 

000 = 2 bytes 
010 = 6 bytes 
100 = 10 bytes 
110 = 14 bytes 


保留 


Tx 复位 ， 该 位 在 FIFO 复位 后 自动 清除 


0= 正 常 


Rx 复位 ， 该 位 在 FIFO 复位 后 自动 清除 


0= ЈЕ 
0 =FIFO 禁止 


001 = 32 bytes 
011 = 96 bytes 
101 = 160 bytes 
111 =224 bytes 


001 = 8 bytes 

011 = 24 bytes 
101 = 40 bytes 
111 = 56 bytes 


001 = 2 bytes 
011 = 6 bytes 
101 = 10 bytes 
111 = 14 bytes 


确定 Rx FIFO 的 触发 电 平 。 如 果 Rx FIFO 数据 计数 小 于 
或 等 于 触发 电 平 ， 将 产生 Rx 中 断 


001 = 64 bytes 

011 = 128 bytes 
101 = 192 bytes 
111 = 256 bytes 


001 = 16 bytes 
011 = 32 bytes 
101 = 48 bytes 
111 = 64 bytes 


001 = 4 bytes 
011 =8 bytes 
101 = 12 bytes 
111 = 16 bytes 


1= Tx FIFO 复位 


1= Rx FIFO 复位 
1 = FIFO 模式 


UART 模 块 有 四 个 UART 接 收 /发 送 状 态 寄存 器 : UTRSTAT0、UTRSTAT1、UTRSTAT2 和 UTRSTAT3， 如 表 6-5 所 示 。 


初始 状态 


00 


00 


* UTRSTATO, К, Address=0xE90_0010 


* ОТКЅТАТІ, R, Address=0xE90_0410 


* UTRSTAT2, R, Address=0xE90_0810 


+ UTRSTAT3, R, Address=0xE90_0C10 


表 6-5 UART 接 收发 送 状 态 寄存 器 


位 名 ж 
Reserved 


在 发 送 缓冲 寄存 器 没有 有 效 数 据 或 发 送 移 位 寄存 器 为 空 
时 ， 该 位 自动 置 1 

0 = 不 空 

1 = 发 送 空 (包括 发 送 缓冲 寄存 器 和 移 位 寄存 需 ) 


В 
发 送 缓冲 寄存 器 为 空 时 ， 该 位 自动 置 ] 
0= 绥 冲 寄存 器 不 为 空 
1 = 缓冲 寄存 器 为 空 (IE FIFO 模式 ,中 断 或 РМА # Ж), 
[1] 在 FIFO 模式 下 ， 如 果 Tx FIFO 触发 电 平 被 设置 为 00 (23), 
则 产生 中 断 请 求 或 DMA 请 求 。 如 果 UART 使 用 FIFO 则 保 
持 UFSTAT 寄存 器 的 Tx FIFO 的 Count bits 和 Full bit， 而 不 
H 


Transmitter empty 


Transmit buffer empty 


对 该 位 检测 

如 果 缓 冲 寄存 器 通过 RXDn 端口 接收 的 数据 包含 有 效 数 
据 ， 该 位 被 自动 置 为 1 

0 = 缓冲 寄存 圳 为 空 

1 = 缓冲 寄存 器 收 到 数据 (ЧЕ FIFO 模式 ， 中 断 或 DMA 请 
求 )， 如 果 UART 使 用 FIFO 则 保持 UFSTAT 寄存 器 的 Rx 
FIFO 的 Count bits 和 Full bit， 而 不 对 该 位 检测 


Receive data 
ready buffer 


(5) UART 发 送 缓冲 寄存 器 (保存 寄存 器 和 FIFO 寄 存 器 ) 

UART 模 块 有 四 个 发 送 缓冲 寄存 器 : UTXH0、UTXH1、UTXH2 和 UTXH3。UTXHn 有 一 个 8 位 数据 作为 发 送 数 据 。 
- UTXHO, W, Address=0xE90_000 

* UTXH1, W, Address=0xE90_040 

- UTXH2, W, Address=0xE90_080 

- UTXH3, W, Address=0xE90_0C0 

(6) UART 接 收 缓冲 寄存 器 (保存 寄存 器 和 FIFO 寄 存 器 ) 

UART 模 块 有 四 个 接收 缓冲 寄存 器 : URXHO、URXH1、URXH2 和 URXH3，URXHn 有 一 个 8 位 数据 作为 发 送 数据 。 
- URXH0, R, Address=0xE90_004 

* URXH1, R, Address=0xE90_044 

+ URXH2, R, Address=0xE90_084 

- URXH3, К, Address=0xE90_0C4 

(7) UART 波 特 率 分 频 寄 存 器 

UART 模 块 有 四 个 波 特 率 分 频 寄 存 器 : UBROIV0、UBRDIV1、UBRDIV2 和 UBRDIV3， 如 表 6-6 所 示 。 

- UBRDIVO, R/W, Address=0xE90_008 

- UBRDIV1, R/W, Address=0xE90_048 

- UBRDIV2, R/W, Address=0xE90_088 

- UBRDIV3, R/W, Address=0xE90_0C8 


表 6-6 UART 波 特 率 分 频 寄存 器 


使 


BROW at 


UBRDIVn |[15:0] | 波 特 率 分 频 值 C4 PCLK 是 UART 的 时 钟 源 ,UBRDIVn 必须 大 于 0(UBRDIVn >0))| 0х0000 


(8) UART 通 道 波 特 率 除数 寄存 器 

UART 模 块 有 四 个 波 特 率 除数 寄存 器 : UDIVSLOT0、UDIVSLOT1、UDIVSLOT2 和 UDIVSLOT3， 如 表 6-7 所 示 。 
+ UDIVSLOTO, R/W, Address=0xE90_00C 

- UDIVSLOT1, R/W, Address=0xE90_04C 

+ UDIVSLOT2, R/W, Address=0xE90_08C 


+ UDIVSLOT3, R/W, Address=0xE90_0CC 


表 6-7 UART 通 道 波 特 率 除数 寄存 器 


UDIVSLOTn 
Reserved 
UDIVSLOTn PEPE AY BITE JV 28 2) Aa ЕИ A RE 


Т) UART 波 特 率 配置 。 


波 特 率 除数 寄存 器 (UBRDIVn) 除 以 分 频 寄存 器 (UDIVSLOTn) 中 存储 的 值 ， 用 来 确定 串口 的 Tx/Rx 时 钟 速率 ( 波 特 率 ) 如 下 : 


DIV_VAL=UBRDIVn+ (num of 1's in UDIVSLOTn) /16 


DIV VAL- (PCLK/ (bpsx16) ) -1 


DIV VAL- (SCLK UART/ (bpsx16) ) -1 


其 中 除数 从 1 到 16。 


UDIVSLOT， 可 以 更 精确 地 产生 波 特 率 。 


例如 ， 如 果 波 特 率 为 1500 bps，SCLK_UART 为 40 MHz， 则 UBRDIVn 和 UDIVSLOTn 是 : 
DIV_VAL= (40000000/ (11500X16) ) -1 

=1.7-1 

=0.7 

UBRDIVn=0 (DIV_VAL 的 整数 部 分 ) 


(num of 1's in UDIVSLOTn) /16=0.7 


ЯВА, (пит of 1's in UDIVSLOTn) =11 


因此 ，UDIVSLOTn 可 以 是 1110_1110_1110_1010 或 者 0111_0111_0111_0101 等 。 


2) UART 时 钟 和 PCLK 的 关系 。 

PCLK 与 UARTCLK 的 比例 有 时 钟 频率 的 约束 。 

UARTCLK 的 频率 与 PCLK 的 频率 的 比值 必须 不 超过 6.5/3 倍 : 
FUARTCLK<=6.5/3xFPCLK 

FUARTCLK=baudratex16 

这 样 做 可 以 有 足够 的 时 间 将 所 接收 的 数据 写 入 Rx FIFO, 

(9) UART 中 断 源 待定 寄存 器 

中 断 处 理 寄 存 器 包括 产生 中 断 的 信息 ， 如 表 6-8 所 示 。 


表 6-8 UART 中 断 源 待定 寄存 器 


п fü 
0 
0x0000 


UINTSPn 位 描 述 复位 值 


Reserved 保留 0 
MODEM 产生 调制 解 调 中 断 0x0 


(10) UART 中 断 屏蔽 寄存 器 

UART 模 块 有 四 个 中 断 屏 茂 寄存 器 : UINTM0、UINTM1、UINTM2 和 UINTM3， 如 表 6-9 所 示 。 
- UINTMO, R/W, Address=0xE90_0038 

< UINTM1, R/W, Address=0xE90_0438 

- UINTM2, R/W, Address=0xE90_0838 


* UINTM3, R/W, Address=0xE90_0C38 


中 断 屏 蔽 寄存 器 包含 那些 中 断 源 被 屏蔽 的 信息 。 如 果 一 个 特定 的 位 被 设置 为 1， 中 断 控制 器 将 不 产生 中 断 请 求 信号 ， 即 使 相应 的 中 断 是 生成 的 。 (注意 : 即使 在 这 样 的 情况 下 ，UINTSPn 寄 存 器 所 对 应 
的 位 也 被 设置 为 1。) 如 果 屏 蔽 位 是 0， 为 相应 中 断 源 的 中 断 请 求 提供 服务 。 


表 6-9 UART 中 断 屏 项 寄存 器 


UINTSPn 位 жа Ж 复位 值 
MODEM [3] 屏蔽 调制 解 调 中 断 0x0 
TXD 0x0 
ERROR [1] 屏蔽 错误 中 断 0x0 


RXD [0] 屏蔽 接收 中 断 0x0 


6.1.2 ”UART 接 口 及 操作 


1.UART 接 口 电 路 


DMA-210XP 设 置 了 两 个 串 行 端口 ， 分 别 为 UART0 和 UART3。 其 中 UART0 使 用 GPA0_0 和 GPA0_1 作 为 数据 线 ; 使 用 GPA0_2 和 GPA0_3 作 为 控制 线 ;，UART3 使 用 GPA1_2 和 GPA_3 作 为 数据 线 。 
电路 如 图 6-3 所 示 。 
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63 串 行 接口 电路 


2.Linux 串 行 接口 操作 


同 所 有 设备 一 样 ，Linux 也 是 通过 设备 文件 来 读 写 串 行 口 数据 ， 即 在 读 写 时 打开 相应 设备 文件 。 在 S5PV210 处 理 器 内 部 有 4 个 UART 单 元 ， 但 这 里 只 留 了 两 个 ， 串 行 端口 接口 UART0 和 UART3 分 别 对 应 的 


设备 文件 /dev/ttySACO 和 /dev/ttySAC3。 
串 行 端口 操作 函数 


串 行 端口 操作 函数 如 下 : 


+ Open 用 于 打开 事 行 口 设备 。 

+ Close 用 于 关闭 串 行 口 设备 。 

+ Read 用 于 从 事 行 端口 设备 上 读 取 数据 。 
+ Write 用 于 往事 行 端口 设备 上 写 数 据 。 


` Ioctd 用 于 串 行 口 设备 除 读 / 写 外 的 控制 操作 。 


在 串 行 端口 通信 中 ，termios.h 是 个 很 重要 的 头 文件 。 


可 使 用 tcgetattr(0 和 tcsetattr() 函 数 获取 和 设置 串 行 端口 属性 。 


Tcgetattr(int _ fd,struct termios * _ termios p) 
Tcsetattr(int _ fd,int — optional actions, const struct termios 
* termios p) 


其 中 ，termios 结 构 体 是 定义 在 Linux 内 核 里 的 数据 结构 ， 用 于 存放 串 行 端口 属性 。 


Termios 结 构 定义 如 下 : 


struct termios { 

tcflag t c iflag; /* input mode flags */ 
tcflag t c oflag; /* output mode flags */ 
tcflag t c cflag; /* control mode flags */ 
tcflag t c lflag; /* local mode flags */ 
cc t c line; /* line discipline */ 

cc t c cc[NCCS]; /* control characters */}; 


对 串 行 端口 属性 的 设置 主要 是 对 c_cflag 参 数 的 不 同位 进行 AND 或 OR 操 作 。 


对 波 特 率 的 设置 使 用 函数 cfsetispeed0 和 cfsetospeed()。 这 两 个 函数 分 别 设置 入 口 端 和 出 口 端的 速率 ， 它 们 也 是 通过 改变 structtermios 结 构 来 实现 的 。 


Cfsetispeed(struct termios * _ termios p,speed t _ speed) 
Cfsetospeed(struct termios * _ termios p,speed t _ speed) 


可 按 如 下 语句 设置 波 特 率 : 
SerialPara.c_cflag |= Baud 
设置 数据 流 控制 : 


Termios.c_cflag &= ~ CRTSCTS 
Termios.c_cflag |= CRTSCTS 
Termios.c_cflag |= IXON | IXOFF | IXANY 


设置 数据 位 : 


Termios.c_cflag &=~ CSIZE 
Termios.c_cflag |= CS8 
Termios.c_cflag |= CS7 


设置 同位 检查 位 : 


Termios.c_cflag & =~ PARENB 
Termios.c_cflag |= PARENB 
Termios.c cflag & = PARODD 
Termios.c_cflag |= PARENB 
Termios.c_cflag & =~PARODD 


6.1.3 UARTiB(STEFPFISTF 


将 DMA-210XP 实 验 平台 上 串 行 口 UART3 连 接 到 PC 的 串 行 口 ， 实 验 平台 的 UART3 使 用 GPA1_2 和 GPA_3 作 为 数据 线 。 编 写 Android 下 PC 与 实验 平台 UART3 的 串 行 通 信 程序 ， 并 将 结果 显示 在 LCD 屏 幕 
E, 


1.UART 界 面 设计 


在 前 一 节 设 计 出 了 驱动 程序 ， 这 一 节 主 要 介绍 如 何 设计 应 用 界面 以 进行 串 行 通信 。 具 体 步 又 如 下 。 


(1) 新 建 工程 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 图 6-4 所 示 菜 单 。 


New d 


Show In Alt+Shiftt# P 


Copy Ctrltc 
Copy Qualified Name 
Ctrlty 


Delete 


pA Export... 


dm Refresh 


6-4 + s Package Explorer? £j 4k 


2) 在 弹出 菜单 中 选择 “New” 一 “Project”， 如 图 6-5 所 示 。 


弹出 如 图 6-6 所 示 窗 口 。 


3) 选择 “Android” 一 “Android Project”， 点 击 “Next” 按 钮 。 弹 出 如 图 6-7 所 示 窗 口 ， 在 相应 位 置 填 入 信息 。 
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图 6-5 ”新 建 工程 
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Ho-6 新建 工 程 窗口 


© New Android Project 


New Android Project ЕТ 
Creates а new Android Project resource. Фф 


Project name: Vart_Control| 


Contents 


(S Create new project in workspace 


O Create project from existing source 


Use default location 


O Create project from existing sample 


Samples: Apilemos 


Build Target 


Target Name 


[C] Android 1.5 
C] Google APIs 
C] Android 1.6 
[] Google APIs 


Android 2.1... 


C] Google APIs 
C] Android 2.2 
[] Google APIs 


П Android 2.3. 


[] Google APIs 


C] Android 2.3. 


[] Google APIs 
C] Android 3.0 
[] Google APIs 
E] Android 3.1 
[] Google APIs 
C] Android 3.2 
[] Google APIs 


Vendor 


Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 
Android Open Source 
Google Inc. 


Standard Android platform 1.5 
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Properties 


Application name: 


® 


图 6-7 新 建 Android 项 目 窗口 


4) 点 击 “Finish” 按 钮 完成 创 寻 


(2) 添加 图 片 资源 


在 项 目 文件 列表 中 添加 


aires | 


片 文件 ， 如 图 6-8 所 示 。 
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图 6-8 ”添加 图 片 资源 


(3) 编辑 main.xml 文 件 ， 进 行 UI 设计 


xml 文 件 的 程序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<RelativeLayout 

xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:orientation-"vertical" 

android:layout widt. fill parent" 

android:layout height-"fill parent" 
android:background-"(drawable/index" 

> 

<TextView 

android: id="@+id/uart_textview" 

android:layout width-"wrap content" 

android:layout height-"wrap content" 
android:text-"DMA-210XP desk to UART item" 
android:textSize-"30px" 

android: textColor="#£ffffff£" 

android: layout_centerHorizontal="true" 

android: layout_alignParentTop="true" 

/> 

<ScrollView 

xmlns:android-"http:// schemas.android.com/apk/res/android" 
android: id="@+id/uart_scrollview" 

android: layout_width="520px" 

android: 1layout_height="230px" 

android: layout_marginTop="35px" 

android: layout_below="@+id/uart_textview" 

android: layout_alignParentRight="true" 

android: layout_marginRight="30px" 

android: background="#f£ffffff£" 

> 

<TextView 

android: id="@+id/uart_view" 

android: layout_above="@+id/uart_text" 

android: layout_widt. fill parent" 

android:layout height="fill parent" 

android: 
android: 
android: 
/> 
</ScrollView> 

<TextView 

android: id="@+id/uart_viewl" 
android: layout_width: 
android:layout heigh 
android: layout_below="@+tid/uart_scrollview" 
android: layout_centerHorizontal="true" 
android: layout_marginTop="30px" 

android: layout_marginLeft="50px" 

android: layout_marginRight="50px" 
android:text="" 

/> 

<EditText 

android: id="@+id/uart_edit" 

android: layout_width="350px" 

android: layout_height="65px" 

android: layout_marginTop=' 
android: layout_marginRight="40px" 

android: layout_below="@+id/uart_scrollview" 
android: layout_alignLeft="@+id/uart_scrollview" 
/> 

<Button 

android: id="@+id/uart_button0" 

android: layout_width="100px" 

android: layout_height="wrap_content" 

android: layout_alignTop="@+id/uart_scrollview" 
android: layout_marginLeft="70px" 
android:text="UART 3" 

/> 


<Button 

android: id="@+id/uart_button2" 

android: layout_width="100px" 

android: layout_height="wrap_content" 

android: layout_marginLeft="70px" 

android: layout _alignBottom="@+id/uart_scrollview 
android: text="CLEAN" Е 

f> 

<Button 

android: id="@+id/uart_button3" 

android: layout_width="100px" 

android:layout height-"wrap content" 

android: layout_alignBaseline="@t+tid/uart_edit" 
android: layout_marginBottom="30dip" = 
android: layout_marginLeft="70dip" 
android:text=" EXIT " 

/> 

<Spinner 

android: id="@+id/uart_mode" 

android: layout_width="100px" 

android:layout height-"wrap content" 

android: layout_below="@+id/uart_button0" 
android:layout marginTop-"l5px" 

android: layout_marginLeft="70px" 

/> 

<Button 

android: id="@+id/uart_button4" 

android:layout width-"wrap content" 
android:layout height-"wrap content" 

android: layout_alignBaseline="@t+tid/uart_edit" 
android: layout_toRightOf="@+id/uart_edit" 
android: layout_alignRight="@+tid/uart_scrollview" 
android:text-" SEND " Е 

/> 

</RelativeLayout> 


这 个 布局 文件 设计 了 四 个 按钮 、 一 个 下 拉 菜单 和 两 个 编辑 区 以 及 一 个 文本 框 ， 设 计 出 来 的 UI 如 图 6-9 所 示 。 


DMA-210XP desk to UART item 


W 


6-9 ”UART 了 驱动 界面 


(4) Uart_Controljava 程 序 代码 编写 


导入 相应 的 包 文件 : 


package tw.com.dmatek.dma210xp.uart; 

import java.util.Timer; 

import java.util.TimerTask; 

import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.AdapterView; 

import android.widget.ArrayAdapter; 

import android.widget .Button; 

import android.widget .EditText; 

import android.widget.Spinner; 

import android.widget.TextView; ikUart_Control 继承 Activity 
public class Uart_Control extends Activity { 


定义 变量 : 


TextView viewl,view2, view; 

Spinner spinnerl; 

String receiveMsg; 

String Msg, str="liwei", ReStr; 

EditText editmsg; 

Button myButton0,myButton2,myButton3,myButton4; 
private boolean signl; 

public int num-1; // 选择 那个 串 行 口 

public int fd,set,i--1,k-0; 

int p; 


private Spinner mySpinner; 


定义 下 拉 字 符 串 数 组 : 


private static final String[] countriesStr = 
( "B1200", "B2400", "В4800", 
"B9600", "В19200", "B38400", "B57600", "B115200", "B230400", "B921600"}; 


private ArrayAdapter<String> adapter; 


定义 myButton0 事 件 处 理 ， 调 用 本 地 方法 打开 串 行 口 ， 设 置 串 行 传输 速率 : 


private Button.OnClickListener myButton0_listener=new 
Button.OnClickListener () 


{ 

public void onClick(View arg0) { 
// TODO Auto-generated method stub 
if (i>0) 

{ 

Linuxc.closeUart (0); 

} 

і=1; 

fd=Linuxc.openUart (3); 

if (fd>0) 


setTitle ("open device sucess!"+String.valueOf (fd) ) 7 
Linuxc.setUart (К); 

signl-true; 

} 

else 


setTitle ("open device false!"+fd); 
signl-false; 

} 

viewl.setText ("The current UART: 3"); 
l 

1; 


定义 myButton2 事 件 处 理 ， 清 空 字符 串 编辑 框 : 


private Button.OnClickListener myButton2_listener=new 
Button.OnClickListener () 


public void onClick(View v) { 

// TODO Auto-generated method stub 
view.setText (null); 

} 

1; 


定义 myButton3 事 件 处 理 ， 关 闭 串 行 | 


private Button.OnClickListener myButton3_listener=new 
Button.OnClickListener () 

{ 

public void onClick(View v) { 

// TODO Auto-generated method stub 

timer.cancel(); 

Linuxc.closeUart (0) ; 

finish(); 

} 

1; 


定义 myButton4 事 件 处 理 ， 调 用 本 地 方法 发 送 串 行 端 口 数据 : 


private Button.OnClickListener myButton4 listener-new 
Button.OnClickListener () 

{ 

public void onClick(View v) { 

// TODO Auto-generated method stub 
Msg=editmsg.getText () .toString(); 

Linuxc.sendMsgUart (Msg) ; 

} 

1; 


定义 时 间 线程 ， 通 过 调用 本 地 方法 不 断 接收 数据 : 


Timer timer = new Timer(); 

/* 新 建 一 个 定时 器 任务 task */ 
TimerTask task = new TimerTask() { 
public void run() { 
runOnUiThread (new Runnable() ( 
public void run() { 

if (signl) { 
ReStr-Linuxc.receiveMsgUart (); 
if (ReStr!-null) 

{ 

view.append (ReStr) ; 
view.append("\n") ; 

ReStr-null; 

l 


Ë 
} 
n; 
} 
} 


构 onDestroy 方 法 ， 关 闭 串 行 口 和 释放 资 


GOverride 
public void onDestroy() 


{ 

signl-false; 
timer.cancel(); 
Linuxc.closeUart (0); 
finish(); 

} 


实现 程序 第 一 次 启动 时 调用 的 方法 onCreate: 


GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


显示 布局 文件 : 


setContentView (R.layout.main) ; 


时 间 线程 调度 : 


timer.schedule(task, 1000, 10); 


获取 资源 ID， 实 例 化 变量 ， 设 置 编辑 框 宽 度 : 


mySpinner- (Spinner) findViewById (R.id.uart mode); 
viewl- (TextView) findViewById(R.id.uart textview); 
view- (TextView) findViewById (R.id.uart view); 
editmsg- (EditText) findViewById (R.id.uart edit); 
editmsg.setWidth (200); 

myButton0- (Button) findViewById (R.id.uart button0) 
myButton2- (Button) findViewById (R.id.uart button2) 
myButton3- (Button) findViewById (R.id.uart button3) 
myButton4- (Button) findViewById (R.id.uart button4) 


为 组 件 设置 监听 事件 : 


myButton0.setOnClickListener (myButton0_listener) ; 
myButton2.setOnClickListener (myButton2_listener) ; 
myButton3.setOnClickListener (myButton3_listener) ; 
myButton4.setOnClickListener (myButton4 listener); 


实例 化 字符 串 适 配器 : 


adapter = new ArrayAdapter<String> (this, 
android.R.layout.simple spinner item, countriesStr) ; 


mySpinner 绑 定 适 配器 : 


adapter.setDropDownViewResource (android.R.layout.simple_spinner_ 
dropdown_item) ; 
mySpinner.setAdapter (adapter) ; 


mySpinner 的 OnltemselectedListener 事 件 监听 ， 调 用 本 地 方法 设置 串 行 口 串 行 传输 速率 : 


mySpinner.setOnItemSelectedListener (new 

Spinner .OnItemSelectedListener () 

{ 

public void onItemSelected (AdapterView<> arg0, View argl, int arg2, 
long arg3) 

{ 


if(fd>0) Linuxc.setUart (arg2) ; 

k=arg2; 

arg0.setVisibility (View.VISIBLE) ; 

} 

public void onNothingSelected (AdapterView<> arg0) 


{ 

// TODO Auto-generated method stub 
} 

D; 


} 


(5) 添加 JNI 函 数 本 地 方法 定义 的 Java 程 序 


右 击 项 目 图 标 ， 在 弹出 菜单 中 点 击 “New” 一 “Class”， 如 图 6-10 所 示 。 


Open Type Hierarchy F4 
Show In 


图 6-10 新建 一 个 类 


弹出 如 图 6-11 所 示 界 面 。 


填写 相应 信息 后 ， 点 击 “Finish” 按 钮 完成 创建 。 


编辑 Linuxc 这 个 Java 文 件 。 这 是 一 个 定义 了 本 地 方法 的 Java 类 ， 并 调用 SO 库 。 程 序 代码 如 下 所 示 : 


package tw.com.dmatek.dma210xp.uart; 
import android.util.Log; 


public class Linuxc { 

static 

{ 

try 

{ 

System. loadLibrary ("uart") ; 

Log.i("JIN", "Trying to load libuart.so"); 


catch (UnsatisfiedLinkError ule) 


{ 
Log.e("JIN", "WARNING: could not load libuart.so"); 
} 


public static native int openUart (int i); 

public static native void closeUart (int i); 
public static native int setUart (int i); 

public static native int sendMsgUart (String msg) ; 
public static native String receiveMsgUart (); 

} 


通过 设计 底层 方法 来 实现 对 驱动 的 调用 。 若 已 有 使 用 事先 编译 的 SO 函数 库 及 JNI 函 数 ， 或 自行 编译 的 动态 链接 库 ， 首 先 将 libs\armeabiNlibuart.so 这 个 文件 拷贝 到 项 目 目录 下 ， 如 图 6-12 所 示 。 请 注意 
路 径 必须 维持 为 libs\armeabiNlibuart.so。 


© Wer Java Class 
Java Class 


Create a rev Java class. 


cota: EEN т 
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De you want to add comments? (Configure tanplates and default valua harel 
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图 6-11 填写 类 名 
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图 6-12 添加 SO 函数 库 
(6) 刷新 项 目 ， 添 加 编译 出 来 的 SO 中 间 库 文件 


选择 项 目 ， 按 F5 键 刷新 项 目 ， 如 图 6-13 所 示 。 


刷新 后 ， 工 程 中 的 SO 文件 如 图 6-14 所 示 。 


* Java - Eclipse SDE [- [m [x 
File Edit Eun Navigate Search Iroject Refactor Window Help 
向 : Ban d Fry | df Таха | 
Ж Go 
a 


BE 


Go Ілі о 


A Show In ALt+Shiftty k 
-E assels 


i Eres. | сә Cer +0 

000] Android = Copy Qualified Кате 
. defanl 5 Paste DrrltV 
3X Data [alata 


Build Tath k 
Rafackeor МАША: АЕТ h 


pg Inport... 
iz Export... 


3 Fie fr esh 
Close Project 


шша та акаа Fre i) š 


Eun As 
Debug As 
Team 
Lompara With 
Restore from Local History... 
Android Tools 
LE i We Босе 


Ye 


6-13 ”刷新 工程 
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图 6-14 ”查看 工程 中 的 SO 


(7) 生成 APK 
6-15 所 示 。 


此 当 把 SO 复制 到 项 目 目录 下 时 ， 它 也 已 经 编译 完成 了 。 生 成 的 APK 在 项 目 目录 的 bin 目 录 下 。 如 图 


由 于 Eclipse 可 以 设 定 自动 编译 功能 ， 因 


Cr .apk workspace), Uart_Control bin 
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16-15 “生成 APK 
到 此 ， 串 行 端口 控制 程序 设计 就 完成 了 。 
2.UART JNI 设 计 
(1) 生成 C 语 言 头 的 Java 文 件 
将 Uart_Control 工 程 拷 贝 到 读者 的 工作 目录 下 ， 工 作 目 录 为 CNapk_workspace\Uart_ Control。 


(2) 编译 Java 文 件 成 C 语 言 的 头 文件 
1) 在 “开始 ”菜单 中 点 击 “ 运 行 ”， 然 后 输入 “cmd” 进 入 DOS 命 令 提 示 符 窗口 ， 如 图 6-16 所 示 。 


j7] Ер ЛЕР. ЭЕ, PSR Internet ЎН 


Hio Windows HEF E a 


HF 0): 


图 6-16 启动 DOS 


2) 进入 CNapk_workspace\Uart_Control 目 录 下 ， 如 图 6-17 所 示 。 


3) 建立 一 个 名 称 为 jni 的 目录 ， 然 后 进入 jni 目 录 ， 如 图 6-18 所 示 。 


jni 这 个 目录 用 于 存放 C 及 C++ 原始 程序 代码 文件 ， 以 及 要 编译 这 些 程序 代码 的 脚本 文件 。 


4) 执行 命令 “javah-classpath “C:\apk_workspace\Uart_Control\bin" tw.com.dmatek.dma210xp.uart.Linuxc" , 


: apk_works pace \BackLight_Control\jni?cd CG:\apk_vorkspace Марке __ Control 


: \apk_workspace Wart Contro l> m 


6-17  3tAUart. Control 142 B Ж 


C: \арк_ vorkspace Mart Control»md jni 


C: vapk workspace Wart_Control>cd jni 


C:\apk_works расе Wart_Control\jni>, 


图 6-18 ”进入 Uart_Conttrol 目 录 创 建 jni 目 录 


如 图 6-19 所 示 ， 在 当前 目录 jni 下 生成 一 个 tw_com_dmatek_dma210xp_uart_Linxuc.h 文 件 。 


RDO¥S\ syst em32\ cad. exe 


С: Харк workspace Wart _Control\jni>javah -classpath ‘C:\apk workspace 
NJart Control*bin" tu.con.dmatek.dma2108xp.uart.Linuxc 


vb de ep _Control\jni>dir 
Whales C HANGE SYSTEM 


类 的 序列 号 22 o982C-?58B 


C:\apk_workspace Wart_Control\jni ABF 


911-10-14 69:40 <DIR> - 
0811-18-14 09:49 <DIR> А 
2911-18-14 rios 1.409 tv -gom. ian tal _dma2i@xp_uart_Linuxc .h 
jt 文件 1.499 545 
个 目录 65.098,428,416 可 用 字 节 


C: \apk_workspace Wart_Control\jni>, 


86-19 ” 饶 看 jni 目 录 中 的 文件 


(3) 编写 调用 C 语 言 头 的 文件 C 程 序 代码 


C 程 序 代码 创 建 一 个 tw_com_dmatek_dma210xp_uart_Linuxc.c 文 件 ， 实 现 tw_com_dmatek_dma210xp_uart_Linuxc.h 这 个 头 文件 中 定义 的 函数 ， 其 程序 码 如 下 。 


定义 头 文件 : 


#include <stdio.h> 
#include <stdlib.h> 
#include «fcntl.h» 
#include <errno.h> 
#include <unistd.h> 
#include "tw_com_dmatek_dma210xp_uart_Linuxc.h" 
#include <sys/types.h> 
#include <sys/stat.h> 
#include <string.h> 
#include <stdint.h> 
finclude <termios.h> 
#include <android/log.h> 
#include <sys/ioctl.h> 
#undef TCSAFLUSH 

#define TCSAFLUSH TCSETSF 
#ifndef TERMIOS H_ 
#define TERMIOS Н 
dendif ` == 


定义 全 局 变量 


int fd; 
struct termios newtio,oldtio; 


实现 本 地 方法 openUart: 


JNIEXPORT jint JNICALL 
Java_tw_com_dmatek_dma210xp_uart_Linuxc_openUart 
(JNIEnv ` *env, jobject mc,jint i) 


{ 
if (i==1) 


{ 
fd-open ("/dev/ttySACl",O RDWR|O NOCTTY|O NDELAY);// ©_NOCTTY 
return fd; 


] 

else if (i==2) { 

fd-open("/dev/ttySAC2",O RDWR|O NOCTTY|O NDELAY); 
return fd; 


else if (i==3) 

fd=open (" pra) O RDWR|O NDELAY|O NOCTTY); 
return fd; 

} 

return fd; 


实现 本 地 方法 closeUart: 


JNIEXPORT void JNICALL 
Java tw com dmatek dma210xp uart Linuxc closeUart (JNIEnv 
*env, jobject mc,jint i) 


{ 
close (Ёа); 
l 


实现 本 地 方法 setUart: 


JNIEXPORT jint JNICALL 
Java_tw_com_dmatek_dma210xp_uart_Linuxc_setUart (JNIEnv *env, jobject 
mc,jint i) 


int 
speed arr[]-(B1200,B2400,B4800, B9600, B19200, B38400, B57600, B115 
200, B230400, B921600) ; 


tcgetattr (fd, &oldtio); 

tcgetattr (fd, &newtio); 

cfsetispeed(&newtio,speed arr[i]); 

cfsetospeed (&newtio, speed arr[il); 

/* newtio.c lflag &= ~ (ІСАМОМ | ЕСНО |ЕСНОЕ | ISIG) ; // 定义 原始 模式 
newtio.c oflag &= -OPOST; // 可 以 收 到 完整 的 数据 , 包括 不 可 打印 字符 与 大 于 128 的 字符 
newtio.c iflag &- ~(BRKINT | ICRNL | INPCK | IXON | ISTRIP ) ; 

newtio.c cflag |= CS8; 

newtio.c cc[VTIME] = 1; // 定义 等 待 时 间 
newtio.c_cc[VMIN] = 1 
x 

newtio.c lflag-0 
newtio.c cflag speed arr[i] | CS8 | CREAD | CLOCAL; 

newtio.c iflag- BRKINT | IGNPAR | IGNCR | IXON | IXOFF | IXANY ; 
newtio.c oflag-02; 

newtio.c line 
newtio.c cc[7 
newtio.c cc[4]-0; 
newtio.c сс[5]=0; 
Де E 
newtio.c lflag-0; 
newtio.c cflag B115200 | CS8 | CREAD | CLOCAL; 
newtio.c iflag- INPCK; 

newtio.c oflag-02; 

newtio.c line-0; 

// newtio.c cc[7]-255; 

newtio.c cc[4]-1; 

newtio.c cc[5]-0; 

НА 

if (tcsetattr (fd, TCSANOW, &newtio) <0) 

{ 

printf ("tcsetattr fail !\n"); 

exit (1); 

} 

return fd; 


} 


实现 本 地 方法 sendMsgUart: 


JNIEXPORT jint JNICALL 
Java tw com dmatek dma210xp uart Linuxc sendMsgUart (JNIEnv 
*env, jobject mc,jstring str) 


int len; 

const char *buf; 

buf=(*env) -»GetStringUTFChars (env, str, NULL) ; 
len= (*env)->GetStringLength (env, str ); 
write (fd, buf, len) ; 

(*env) ->ReleaseStringUTFChars (env, str, buf); 
} 


实现 本 地 方法 receiveMsgUart: 


JNIEXPORT jstring JNICALL 
Java_tw_com_dmatek_dma210xp_uart_Linuxc_receiveMsgUart (JNIEnv 
*env, jobject mc) 


char buffer[255]; 
char buf [255]; 
int len, i=0,k=0; 
memset (buffer, 0, sizeof (buffer) ) ; 
memset (buf, 0, sizeof (buf) ); 
printf ("Nn"); 
len=read (fd, buffer, 255); 
if (len»0) 
{ 
android_log print (ANDROID LOG INFO,"len","len =%d, 
buffer [0]=%c, buffer [1] =%с\п", len, buffer [0] , buffer [1]) ; 
__android_log_print (ANDROID LOG INFO, "buffer", "buffer=%s\n", buff 
er); 
// return (*env)-»NewStringUTF (env, buffer) ; 
} 
е1ве 
return NULL; 
} 


(4) 创建 生成 SO 的 配置 文件 


现在 jni 目 录 下 已 经 有 tw_com_dmatek_dma210xp_led_Linuxc.h 和 tw_com_dmatek_dma210xp_led_Linuxc.c 这 两 个 文件 。 还 需要 添加 一 个 脚本 文件 实现 编译 链接 ， 其 文件 名 为 Android.mk， 其 代码 
如 下 : 


LOCAL PATH := $ (call my-dir) 

include $ (CLEAR VARS) 

LOCAL MODULE := uart 

LOCAL SRC FILES := tw com dmatek dma210xp uart Linuxc.c 
include $(BUILD SHARED LIBRARY) 


(5) 生成 SO 动态 链接 库 


打开 Cygwin 终 端 ， 进 入 CNapk_workspace\Uart_Control 目 录 ， 然 后 执行 “ndk-build” 命 令 即 可 。 如 图 6-20 所 示 ， 人 生成 需要 的 动态 链接 库 SO。 


ndk-build 


/cyugqdrive/c 


cd apk_workspace/Uart_Control 


“eygdrivec/Hapk_workspacc/“Uart_Control 


ompile thumb uart <= tw_com_dmatek_dmaZ14xp_uart_Linuxce .c 


6.1.4 ПАКТ РЕЛ, 


SharedLibrary libuart.so 


libuart.so => libs/armeahi/libuart.so 


/cygdriue/c/apk workspace/llart Control 


6-20 ”生成 动态 链接 库 


测试 自己 编写 的 UART 程 序 ， 步 骤 如 下 : 


1) 打开 DMA-210XP 平 台 的 电源 ， 启 动 系统 。 


2) 安装 好 应 用 程序 。 

3) 启动 程序 。 

串 行 口 的 测试 需要 一 个 具有 串 行 端口 的 PC 主机 ， 将 PC 的 串 行 口 使 用 串 行 线 连接 到 DMA-210XP 平 台 上 。 打 开 应 用 程序 ， 如 图 6-21 所 示 。 

点 击 UART3 下 的 “B1200” 安 装 设置 波 特 率 为 115200， 点 击 “UART3” 按 钮 ， 打 开 串 行 端口 。 

可 以 发 现 打 开 串 行 端口 成 功 的 信息 ， 可 以 在 SEND 旁 边 的 文本 框 中 输入 要 发 送 的 信息 ， 点 击 “SEND” 按 钮 发 送 这 个 信息 即 可 ， 如 图 6-22 所 示 。 


图 6-21 串 行 端口 应 用 程序 启动 界面 


The current UART : 3 


6-22 发 送信 息 


如 果 在 PC 端 发 送信 息 ， 在 文本 域 中 可 以 看 到 结果 ， 如 图 6-23 所 示 。 


在 DMA-210XP 实 验 平台 上 接收 到 信息 ， 如 图 6-24 所 示 。 
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图 6-23 ”PC 端 发 送信 息 


open device sucess!43 


The current UART : 3 


96-24 DMA-210XP 实 验 平台 接收 的 信息 


6.2 “CC 总 线 接口 及 驱动 程序 


6241 ПСА 


1.1C 总 线 概述 


S5PV210 处 理 器 支持 一 个 多 主 IIC 串 行 总 线 接 口 。 一 根 专 用 串 行 数据 线 SDA 和 一 根 串 行 时钟 线 SCL 在 总 线 主机 和 连 到 IC 总 线 上 的 外 设 之 间 传 输 数据 ，SDA 和 SCL 都 是 双向 的 。 


在 多 主 IIC 总 线 模式 下 ， 处 理 器 能 与 从 设备 接收 或 者 发 送 串 行 数据 。S5PV210 主 机 可 以 初始 化 和 停止 一 次 基于 IC 总线 的 传输 ，S5PV210 上 的 IC 总 线 使 用 标准 的 总 线 仲裁 策略 。 


为 了 控制 多 主 IIC 总 线 操作 ， 必 须 设置 好 如 下 寄存 器 : 


“ 多 主 IIC 总 线 控制 寄存 器 ，IICCON。 

“ 多 主 IIC 总 线 控 制 /状态 寄存 器 ，IICSTAT。 

“ 多 主 IIC 总 线 Tx/Rx 移 位 寄存 器 ，IICDS。 

“ 多 主 IIC 总 线 地 址 寄存 器 ，IICADD。 

当 lIC 总 线 空闲 时 ，SDA 和 SCL 线 都 处 于 高 电 平 状态 ， 当 SCL 保 持 高 电 平时 ， 一 个 SDA 下 降 沿 可 以 初始 化 一 个 起 始 条件 ， 当 SCL 保 持 高 电 平 时 ，SDA 的 一 个 上 升 沿 可 以 初始 化 一 个 停止 条 件 。 


起 始 和 停止 条 件 总 是 由 主 设备 发 起 的 ， 起 始 条 件 停止 后 第 一 个 字 节 是 一 个 7 位 地 址 值 一 一 决定 总 线 主 选择 哪个 从 设备 。 第 8 位 决定 此 次 传输 的 方向 ( 读 还 是 写 ) 。 


发 送 到 SDA 上 的 每 个 数据 必须 是 8 位 的 ， 在 整个 总 线 传输 操作 期 间 字 节 可 以 被 无 限 地 发 送 和 接收 。 数 据 总 是 从 MSB 开 始 传输 ， 所 有 字 节 后 都 必须 跟 1 个 ACK 应 答 位 。 


lIC 总 线 模块 图 如 图 6-25 所 示 。 


2.11C 操 作 


S5PV210 的 IIC 总 线 接 口 有 四 种 操作 模式 : 主 控 器 发 送 模式 、 主 控 器 接收 模式 、 从 属 器 发 送 模式 和 从 属 器 接收 模式 。 
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图 6-25 IIC 总 线 模块 图 
接 下 来 介绍 这 些 操 作 模式 之 间 的 功能 关系 。 


(1) 开始 和 停止 条 件 


11C 总 线 接口 无 效 时 ， 它 通常 是 在 从 属 器 模式 下 。 换 名 话说 就 是 ， 在 SDA 线 检测 一 个 开始 条 件 前 (当时 钟 信 号 SCL 在 高 位 时 ，SDA 线 发 生 高 位 到 低位 的 跃 变 ， 开 始 条 件 启动 ) ， 接 口 必须 在 从 属 器 模式 
下 。 当 接口 状态 变 为 主 控 器 模式 时 ， 在 SDA 线 上 的 数据 开始 传输 ， 并 且 产 生 SCL 信 和 号 


开始 条 件 能 通过 SDA 线 传输 一 个 字 节 的 串 行 数据 。 一 个 停止 条 件 能 结束 该 数据 传输 。 主 控 器 能 一 直 产生 开始 和 停止 条 件 。 当 一 个 开始 条 件 产生 后 ，11C 总 线 获得 繁忙 信号 。 停 止 条 件 将 使 1C 总 线 空闲 。 


当主 控 器 发 起 一 个 开始 条 件 ， 它 将 发 送 一 个 从 属地 址 来 通知 从 属 器 设备 。 一 个 字 节 的 地 址 域 包含 7 位 地 址 和 1 位 传输 方向 指示 器 (表示 写 或 读 ) 。 如 果 第 8 位 是 0， 表 示 写 操作 (发 送 操作 ) ; 如 果 第 8 位 
是 1， 表 示 请 求 读 取 数据 (接收 操作 ) 。 


主 控 器 通过 发 出 一 个 停止 条 件 来 完成 传输 操作 。 如 果 主 控 器 想 继续 将 数据 发 送 到 主线 ， 它 将 产生 另 一 个 开始 条 件 和 一 个 从 属地 址 。 通 过 这 种 方式 ， 读 写 操作 能 在 不 同 的 格式 下 执行 。 
(2) 数据 传输 格式 


在 SDA 线 上 的 每 一 个 字 节 长 度 必须 是 8 位 。 起 始 条 件 后 的 第 一 个 字 节 有 一 个 地 址 域 。 当 IIC 主 线 在 主 控 器 模式 下 操作 时 ， 地 址 域 能 通过 主 控 器 传输 。 每 一 个 字 节 后 面 跟随 一 个 
ACK (acknowledgement) 位 。MSB 位 始终 首先 发 送 。11C 总 线 数 据 传输 的 模块 图 如 图 6-26 所 示 。 


(3) ACK 信 号 传输 


为 了 完成 一 个 字 节 的 发 送 操作 ， 接 收 器 必须 将 一 个 ACK 位 发 送 到 发 送 器 。ACK 脉 冲 在 SCL 线 的 第 9 个 时 钟 产 生 。 对 于 发 送 一 个 字 节 来 说 ，8 个 时 钟 是 必要 的 。 主 控 器 将 产生 一 个 时 钟 脉冲 来 发 送 一 个 ACK 
位 。 当 ACK 时 钟 脉冲 被 接收 时 ， 通 过 使 SDA 置 高 位 ， 发 送 器 释放 SDA 线 。 在 传送 ACK 时 钟 脉冲 期 间 ， 接 收 器 驱使 SDA 线 置 低位 ， 以 使 5;DA 线 在 第 9 个 SCL 脉 冲 的 高 位 时 期 保持 低位 。ACK 位 传输 功能 通过 软件 
(IICSTAT) 来 激活 或 者 禁止 。 然 而 ， 在 SCL 的 第 9 个 时 钟 ， 要 求 ACK 脉 冲 完成 一 个 字 节 的 数据 传输 操作 。 


MR 来 自 接收 器 的 确认 信号 来 自 接收 器 的 确认 信和 号 


SCL ! \ fh, 2h 7 8 9 1 2 EN $91 / 
' S! Е АСК f t 1 
字 节 完成 ， 接 收 器 内 的 中 断 时 钟 线 被 接收 器 和 /或 发 送 器 保持 低位 


图 6-26 IIC 总 线 数据 传输 的 模块 图 


(4) 读 写 操作 


在 发 送 模式 下 ， 当 发 送 数据 时 ，11C 总 线 接口 将 一 直 等 待 ， 直 到 数据 移 位 (IICDS) 寄存 器 接收 到 一 个 新 的 数据 。 新 的 数据 写 入 寄存 器 之 前 ，SCL 线 将 被 保持 在 低位 ， 数 据 写 入 后 释放 。S5PV210 保 持 中 
断 来 确定 当前 数据 发 送 完成 。CPU 接 收 中 断 请 求 后 ， 它 将 新 的 数据 写 入 IICDS 寡 存 器 。 


在 接收 模式 下 ， 当 接收 数据 时 ，IICDS 寄 存 器 被 读 取 前 ，IC 总 线 接口 将 一 直 等 待 。 在 新 的 数据 被 读 出 前 ，SCL 线 将 保持 低位 ， 读 取 后 释放 。S5PV210 保 持 中 断 来 确认 新 的 数据 接收 完成 。CPU 接 收 到 中 
请 求 后 ， 它 从 IICDS 寄 存 器 读 取 数据 。 


(5) 异常 中 断 条 件 


如 果 一 个 从 属 接收 器 不 承认 该 从 属地 址 ， 它 将 保持 SDA 线 为 高 位 。 在 这 种 情况 下 ， 主 控 器 产生 一 个 中 断 条 件 中 断 传输 。 中 断 传 输 和 主 控 器 的 接收 器 是 有 关 的 。 来 自从 属 器 的 最 后 数据 字 节 被 接收 后 ， 通 
过 取消 一 个 ACK 的 产生 ， 通 知 从 属 发 送 器 操作 结束 。 从 属 发 送 器 释放 SDA 来 允许 主 控 器 产生 一 个 停止 条 件 。 


(6) IC 和 总线 配 置 


为 了 控制 串 行 时 钟 的 频率 (SCL) ， 在 lICCON 寄 存 器 中 ,执行 4 位 的 预 分 频 值 。11C 总 线 接口 地 址 被 存储 在 lIC 总 线 地 址 (IICADD) 寄存 器 。 基 于 默认 ，11C 总 线 地 址 有 一 个 未 知 值 。 


3.1IC 专 用 寄存 器 


1IC 总 线 接 口 控制 寄存 器 如 表 6-10~ 表 6-14 所 示 。 


(1) 多 主 设备 lIC 总 线 控制 寄存 器 

-TICCONO, R/W, Address=0xE180_0000 
-IICCON1, R/W, Address=0xE1A0_0000 

-IICCON. нрмі рос, R/W, Address-OxFABO 0000 


: IICCON_HDMI_PHY, R/W, Address=0xFA90_0000 


6-10 多 主 设备 IIC 总 线 控 制 寄存 器 


IIC 总 线 确认 有 效 位 
0: 无 效 
确认 产生 (1) [7] 1: 有 效 0 
发 送 模式 下 ， 在 确认 期 间 ，IICSDA 空闲 
接收 模式 下 ， 在 确认 期 间 ，ICSDA Z L 
ПС 总 线 发 送 时 钟 预 分 频 选 择 位 的 源 时 钟 
发 送 时 钟 源 选 择 [6] 0: IICCLK = fPCLK /16 0 
1: IICCLK - fPCLK /512 
C ПС 总 线 发 送 /接收 中 断 有 效 / 无 效 位 
AR /接收 中 断 CS) [5] 0. XX, 1. 有效 0 
ПС 总 线 发 送 /接收 中 断 等 待 标志 。 当 该 位 以 1 被 读 取 时 ， 
IICSDL 连接 到 工 并 且 IC 停止 。 为 了 恢复 操作 ， 清 除 该 位 
为 0 
中 断 等 待 标志 (2)(3) [4] 0: (1) 无 中 断 等 待 ( 读 时 ) 0 
(2) 清除 等 待 条 件 并 且 恢 复 操作 〈 写 时 ) 
1: C1) 等 待 中 断 ( 读 时 ) 
(2) N/A СЕНУ) 


IIC 总 线 发 送 时 钟 预定 标 器 
发 送 时 钟 值 CA) [3:0] ПС 总 线 发 送 时 钟 频率 由 4 位 预 分 频 值 决定 ， 格 式 如 下 : 未 定义 


发 送 时 钟 =IICCLK/ (IICCON[3: 0]+1) 


(2) 多 主 设备 IC 总线 控制 /状态 寄存 器 

- IICSTATO, R/W, Address=0xE180_0004 

- IICSTAT1, R/W, Address=0xE1A0_0004 

: IICSTAT_HDMI_DDC, R/W, Address=0xFABO_0004 


: HCSTAT_HDMI_PHY, R/W, Address=0xFA90_0004 


表 6-11 多 主 设备 IIC 总 线 控 制 /状态 寄存 器 


IICSTAT 初始 状态 


IC 总 线 主 控 器 / 从 属 器 发 送 / 接收 模式 选择 位 
00: 从 属 硕 接收 模式 
模式 选择 01: 从 属 絮 发 送 模式 00 
10: 主 控 器 接收 模式 
11: XP AE a yK 


ИС 总 线 繁忙 信号 状态 位 
0: (E) 不 繁忙 ( Ij 


繁忙 信号 状态 /START ( 写 ) 停止 信号 产 е 
STOP 条 件 . (GE) 繁忙 [e m 


(5) START 信号 产生 
在 开始 信号 后 ，IICDS 中 的 数据 将 自动 发 送 


(Ж) 
IICSTAT 位 ж X 初始 状态 
IIC 总 线 数据 输出 有 效 /无 效 位 
vg у 
连续 输出 [4 0: 无 效 接收 / 发 送 , 1: 有 效 接收 / 发 送 " 
IIC 总 线 裁定 程序 状态 标志 位 
仲裁 状态 标志 [3] 0: 总 线 裁定 成 功 0 
: 在 串 行 VO 过 程 中 ， 总 线 裁定 失败 
ПС 总 线 地 址 作为 从 属 状态 标志 位 
м (Е ур 
Él AE A АЖ [2] 0: i£ IIC 总 线 寄存 器 后 清除 0 


1: 接收 的 从 属 器 地 址 匹配 ICADD 中 的 地 址 值 
IIC 总 线 地 址 0 状态 标志 位 
地 址 0 状态 标志 [1] О: 当 检 测 到 开始 /停止 条 件 时 清除 0 
1: 接收 的 从 属 器 地 址 是 00000000b 
IIC 总 线 最 后 接收 位 状态 标志 位 
最 后 接收 位 状态 标志 [0] 0: 最 后 接收 位 为 0 (ACK 被 接收 ) 0 
1: 最 后 接收 位 为 1 (АСК 没有 被 接收 ) 


(3) 多 主 设备 lIC 总 线 地 址 寄存 器 

- IICADDO, R/W, Address=0xE180_0008 

: IICADD1, R/W, Address=0xE1A0_0008 

: IICADD_HDMI_DDC, R/W, Address=0xFAB0_0008 


: HCADD_HDMI_PHY, R/W, Address=0xFA90_0008 


表 6-12 ”多 主 设备 IIC 总 线 地 址 寄存 器 


IICADD 初始 状态 
7 位 从 属 器 地 址 
当 IICSTAT 中 串 行 输出 有 效 位 为 0 时 , IICADD 写 有 效 。 不 

БВ 6 Hb hl: : 管 当 前 串 行 输出 有 效 位 CIICSTAT) 的 设置 怎样 ，ICADD 值 都 | XXXXXXXX 


能 被 读 取 
从 属 器 地 址 : [7: 1] 无 映射 : [0] 


(4) 多 主 设备 lIC 总 线 接收 发 送 数 据 移 位 寄存 器 


- IICDS0, R/W, Address=0xE180_000C 


- IICDS1, R/W, Address=0xE1A0_000C 


: IICDS_HDMI_DDC, R/W, Address=0xFAB0_000C 


: IICDS_HDMI_PHY, R/W, Address=0xFA90_000C 


表 6-13 多 主 设备 IIC 总 线 接收 发 送 数据 移 位 寄存 器 


IICDS 初始 状态 
用 于 IC 总 线 发 送 / 接收 操作 的 8 位 数据 移 位 寄存 器 。 
数据 移 位 当 IICSTAT 中 串 行 输出 有 效 位 为 1 时 ，IICDS 写 和 人 有效。 无 论 当 |  XXXXXXXX 
前 串 行 输出 有 效 位 (IICSTAT) REEE, ICDS 值 都 能 被 读 取 
(5) 多 主 设备 |IC 总 线 线路 控制 寄存 器 
- IICLCO, R/W, Address=0xE180_0010 
- IICLC1, R/W, Address=0xE1A0_0010 
: IICLC HDMI DDC, R/W, Addressc0xFABO 0010 
: IICLC. HDMI. PHY, R/W, Address=0xFA90_0010 
表 6-14 多 主 设备 IIC 总 线 线路 控制 寄存 器 
IICLC 初始 状态 
ПС 总 线 过 滤器 有 效 位 
滤波 器 有 效 当 SDA 端口 用 于 输入 操作 ， 该 位 应 当 置 高 位 。 在 两 倍 的 PCLK 0 
时 间 期 间 ， 过 滤器 能 预防 由 于 失灵 而 发 生 的 错误 
ПС 总 线 SDA 线 延迟 长 度 选 择 位 
线 被 以 下 时 钟 时 间 延 迟 (PCLK): 
SDA iusti one Ona w 


10: 10 时 钟 , 11: 15 时 钟 


6.2.2 ”在 Linux 内 核 中 添加 IIC 设 备 


1.1C 与 mcu 芯 片 接口 电路 


lIC 总 线 的 mcu 为 IC B，mcu 芯 片 地 址 为 0xa0， 如 图 6-27 所 示 。 


T 
à 


图 6-27 IIC 与 mcu 芯 片 接 口 


2. 将 设备 注册 到 IC 总线 


在 内 核 中 将 设备 注册 到 IIC B 总 线 上 ， 这 样 才能 通过 IIC 访 问 mcu 上 的 数据 。 修 改 kernel/inch/arch/arm/mach-meson3/board-m3-reff17.c， 在 i2c_board _info_initdata ат! i2c bus info_1[0 结 构 体 
中 注册 设备 (若是 i2c A, Wüfri2c bus _info_0[] 中 注册 ) . 


[java] view plaincopy 
static struct i2c board info _ initdata aml i2c bus info 1[] = { 
// elevator 


I2C BOARD INFO("elevator ", Oxa0), 
h 
J; 


3 .重新 编译 内 核 


make ulmage 并 更 新 ulmage。 


6.2.3 IC 驱动 程序 设计 


S5PV210 的 IC 总 线 与 EEPROM 芯片 mcu 连 接 ， 电 路 如 图 6-27 所 示 。mcu 作 为 1IC 从 设备 ， 其 地 址 为 0xa0。 编 写 Android 下 实验 平台 IC 总线 对 mcu 芯 片 进行 读 / 写 操作 。 


1.Java 程 序 设 计 
(1) 新 建 工程 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 图 6-28 所 示 的 菜单 。 


2) 在 弹出 的 菜单 中 选择 “new”-> “Project”， 如 图 6-29 所 示 。 


AlttShifttW > 


Ctrltt 


ВӘ Copy Qualified Name 
B Faste CtrltV 


Delete 


96-28 Package Explorer € € Ab 


6-29 ”新 建 工 程 项 目 
3) 选择 “Android”-> "Android Project”， 点 击 “next” 按 钮 。 在 相应 位 置 填 入 信息 。 点 击 “Finish” 按 钮 完成 创建 。 
(2) 编写 licjava 程 序 代码 


1) 导入 相应 的 包 文件 : 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 


2) 让 Uart_Control 继 承 Activity: 


public class I2cRadioTest extends Activity { 
private static final String TAG = "I2cRadioTest"; 


3) 实现 程序 第 一 次 启动 时 调用 方法 onCreate: 


GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
int[] buf = new int[4]; 
int slaveAddr = OxXX; 
int fileHander; 
int mode = OxXX | OxXX; 
int i; 

I2c i2c = new I2c(); 

fileHander = i2c.open("/dev/i2c-1"); 


4) 读 IIC 设 备 : 
i2c.read(fileHander, slaveAddr, buf, 4); 
Log.w (ТАС, 
"buf0= " + Integer.toHexString(buf[0]) + " bufl= " 
+ Integer.toHexString(buf[1]) + " buf2- " 
+ Integer.toHexString(buf[2]) +" buf-3 " 
+ Integer.toHexString (buf[3])); 


buf [0] = 0x01; 
i = 0;// i2c.write(fileHander, slaveAddr, mode, buf, 1); 
Log.w (TAG, "write length " + i); 
for (int j = o; J < 4; 1+ { 
buf[i] = 
} 
i2c.read(fileHander, slaveAddr, buf, 4); 
"buf0- " + Integer.toHexString(buf[0]) + " bufl= " 
+ Integer.toHexString(buf[1]) + " buf2- " 
+ Integer.toHexString (buf[2]) +" buf-3 " 
+ Integer.toHexString (buf [3]) ) 
i2c.close (fileHander) ; 


if ((buf[0] & 0x10) == 0x01) { 
Log.w (ТАС, 

} else { 
Log.w (TAG, 


} 


5) 显示 布局 文件 : 


setContentView (R.layout.main) ; 


6) lIC 操 作 类 : 


public class I2c { 
n 
m Gparam nodeName 
node path name 

* @return return file hander else return «0 on fail 
Xp 
public native int open(String nodeName); 
/** 
* @param fileHander 


* @param i2c_adr 

= “slave addr 
* @param buf 

* @param Lenth 

^ of buf 

* @return read length 

* 


public native int read(int fileHander, int i2c adr, int buf[], int Length); 
p zs 


* 
* @param fileHander 
* @param i2c adr 
* “slave addr 
* @param sub_adr 
а sub addr 
* @param buf 
* @param Lenth 
£ of buf 

* @return write length 

* 

/ 
public native int write(int fileHander, int i2c adr, int sub adr, 
int buf[], int Length); Е si 
public native void close (int fileHander); 
static { 
System. loadLibrary ("test-i2c") ; 
) 


2.11C 总 线 JNI 设 计 


(1) 新 建 jni 目 录 


Ий] 


首先 找到 amlogicAD 目 录 并 在 该 目录 下 新 建 目录 ， 并 命名 为 “jni”， 如 


6-30 所 示 。 


Aue ONCE FRE 


ж кй 


irs) 


6-30 ”新 建 jni 目 录 


(2) 编写 Android.mk 


[plain]view plaincopy 

LOCAL PATH := $ (call my-dir) 

include $ (CLEAR VARS) 

LOCAL MODULE := i2c elevator // name of so 

LOCAL_SRC_FILES i2c elevator.c // c file 

LOCAL LDLIBS := -llog 

LOCAL C INCLUDES := $ (МҮ ANDROID SOURCE) /frameworks/base/core/jni/android/graphics \ 


$ (МҮ ANDROID SOURCE) /external/skia/include/core V 


$ (МҮ ANDROID SOURCE) /external/skia/include/images \ 
$ (MY ANDROID SOURCE) /frameworks/base/include V 
$(MY ANDROID SOURCE) /system/core/include 


include $(BUILD SHARED LIBRARY) 


(3) 利用 javah 生 成 jni 头 文件 


1) 用 avah 命 令 自动 生成 头 文件 需要 在 Java 代 码 中 先 声明 该 函数 。 程 序 需要 在 Serial-Thread.java 中 调用 jni 来 操作 i2c, 先 用 public native 来 声明 open()、read()、write() 和 colse() 函 数 ， 它 们 分 别 与 
i2c_elevator.c 的 函数 对 应 。 


[java] view plaincopy 
public static class I2c { 
/** 


* @param nodeName 


ie node path name 
* @return return file hander else return «0 on fail 
* 
/ 
public native int open(String nodeName); 
[ee 
* @param fileHander 
* @param i2c_adr 
* slave addr 
* @param buf 
* @param Lenth 
x of buf 
* @return read length 
* 
/ 
public native int read(int fileHander, int i2c adr, byte buf[], int Length); 
"n 
* (param fileHander 
* (param i2c adr 
£ “slave addr 
* @param sub_adr 
$ sub addr 
* @param buf 
* @param Lenth 
* of buf 
* @return write length 
* 
public native int write(int fileHander, int i2c adr, int sub adr, int buf[], int Length); 
public native void close(int fileHander); = ~ 


2) 从 Linux 终 端 进入 项 目 目录 ， 代 码 如 下 所 示 。 


tony@tony-desktopo:~/sda7/eclips_dt/amlogicAD lic 
tony@tony-desktopo:~/sda7/eclips dt/amlogicAD 11с pwd 
/home/tony/sda7/eclips dt/amlogicAD iic 
tony@tony-desktop:~/sda7/eclips_dt/amlogicAD_iic 


找到 SerialThreadjava 对 应 的 class 文 件 ， 用 javah 命 令 自 动 生成 头 文件 : javah-classpath bin/classes-d jni peter.amlogic.serial.SerialThread, #%: classpath 指 定 classes 的 目录 ，-d: 指 定 jni 目 录 。 
代码 如 下 所 示 。 


tony@tony-desktop:~/sda7/eclipse_dt/amlogicAD_iic javah -classpath bin/classes -d jni peter.amlogic,serial.SerialThread 
tony@tony-desktop:~/sda7/eclipse_dt/amlogicAD_iic 


运行 此 命令 后 ,会 在 jni 目 录 下 生成 符合 jn 规范 的 头 文件 。 


3) 打开 peter_ amlogic serial SerialThread 12c.h 文 件 ， 找 到 和 前 面 SerialThreadjava 文 件 中 的 函数 相对 应 的 函数 名 称 ， 代 码 如 下 所 示 。 


#ifdef cplusplus 
extern "C" 


#endif 
/* 
* Class: peter amlogic serial SerialThread I2c 
* Method: open 
* Signature: (Ljava/lang/String;)I 
t, 


JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c open(JNIEnv *, jobject, jstring); 


/* 
* Class: peter amlogic serial SerialThread I2c 
* Method: read 
ies 


JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c read(JNIEnv *, jobject, jstring); 
* 


* Class: peter amlogic serial SerialThread I2c 
* Method: write 
*/ 


JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c write(JNIEnv *, jobject, jstring); 


/* 
* Class: peter amlogic serial SerialThread I2c 
* Method: close 
х 


JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c close(JNIEnv *, jobject, jstring); 
#ifdef _ cplusplus 


在 i2c_elevator.c 中 ， 函 数 名 称 应 该 和 peter_amlogic_serial_SerialThread 12c.h 一 致 ， 才 能 被 识别 。 


(4) 新 建 i2c_elevator.c 文 件 


在 jni 目 录 下 新 建 i2c_elevator.c 文 件 。java 层 主要 通过 该 文件 中 的 函数 来 实现 i2c 的 读 写 等 操作 。 函 数 名 称 


peter amlogic serial SerialThread 12c.h 中 的 函数 名 称 。 


[cpp] view plaincopy 
#include <jni.h> 
#include <stdio.h> 
#include <unistd.h> 
#include <string.h> 
#include <android/log.h> 
#include <linux/i2c.h> 
#include <linux/delay.h> 
#include <linux/time.h> 
#include <sys/types.h> 
#include <sys/stat.h> 
#include <sys/ioctl.h> 
#include <fcntl.h> 
#include <errno.h> 
#include «assert.h» 
#include <string.h> 
#tdefine CHIP ADDR 0xa0// mcu i2c addr 
#define I2C БЕУ "/dev/i2c-1"// register i2c B bus 
#define LOG TAG "i2c"// android logcat 
#tdefine LOGI (http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/...) 
. android log print (ANDROID LOG INFO,LOG TAG, ҮА ARGS ) 
#define LOGE (http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...) 
. android log print (ANDROID LOG ERROR, LOG TAG, VA ARGS ) 
static int read eeprom(int fd, char buff[], int addr, int count) 
{ 
int res; 
int i; 
for (1=0; i«PAGE SIZE; i++) 


buff [1]=0; 


} 
if(write(fd, &addr, 1) != 1) 
return -1; 
usleep (10000); 
res-read(fd, buff, count); 
LOGI ("read $d byte at 0x%.2x\n", res, addr); 
for(i-0; i«PAGE SIZE; i++) 


LOGI("Ox$.2x, ", buff[i]); 


} 
return res; 
} 
static int write_eeprom(int fd, char buff[], int addr, int count) 
{ 
int res; 
int i; 
char sendbuffer[PAGE_SIZE+1]; 
memcpy (sendbuffer+1, buff, count); 
sendbuffer[0]=addr; 
res= write(fd, sendbuffer, count+1); 
LOGI ("write $d byte at 0х%.2х\п", res ,addr); 
usleep (10000) ; 
for (1=0; i«PAGE SIZE; i++) 
LOGI ("0х%.2х, ", buff[i]); 
} 


} 
JNIEXPORT jint JNICALL 


Java peter amlogic serial SerialThread 0002412c open(JNIEnv *env, jobject obj, jstring file) 
{ 


char fileName [64]; 
const jbyte *str; 
str = (*env)-»GetStringUTFChars (env, file, NULL); 
if (str == NULL) { 
LOGI ("Can't get file name!"); 
return -1; 


} 


sprintf (fileName, "%s", str); 

LOGI ("will open i2c device node %s", fileName); 
(*env) ->ReleaseStringUTFChars (env, file, str); 
return open (fileName, O_RDWR); 


} 
JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c read(JNIEnv * env, 


jint *bufint; 
char *bufByte; 


int res = 0, i = 0, j = 0; 
if (len <= 0) { 
LOGE ("I2C: buf len <=0"); 
goto err0; 
} 
bufint = (jint *) malloc(len * sizeof (int)); 
if (bufint == 0) { 
LOGE ("I2C: потем"); 
goto err0; 
} 
bufByte = (char*) malloc (len); 


if (bufByte == 0) { 
LOGE ("I2C: nomem") ; 
goto errl; 
l 
(*env)-»GetIntArrayRegion (env, bufArr, 0, len, bufint); 
memset (bufByte, '\0', len); 


if ((j = read(fileHander, bufByte, len)) != len) { 
LOGE ("read fail in i2c read jni і = $d buf 4", i); 
goto err2; 
} else 


for (i = 0; i <j ; i++) 
bufint[i] = bufByte[i]; 


jobject obj, jint fileHander, jint slaveAddr, jintArray bufArr, jint len) 


LOGI ("return $d %d $d $d in i2c read jni", bufByte[0], bufByte[1], bufByte[2], bufByte[3]); 


(*env)-»SetIntArrayRegion (env, bufArr, 0, len, bufint); 

} 

free (bufByte) ; 

free (bufint) ; 

return j; 
err2: 

free (bufByte) ; 
errl: 

free (bufint) ; 
err0: 

return -1; 


} 
JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c write(JNIEnv *env, 
{ 
#if 0 
jint *bufint; 
char *bufByte; 


int res = 0, i=0, 0; 


if (len <= 0) { 
LOGE("I2C: buf len <=0"); 
goto err0; 
} 
bufint = (jint *) malloc(len * sizeof (int)); 
if (bufint 0) { 
LOGE ("I2C: потем"); 
goto err0; 
} 
bufByte = (сһаг*) malloc(len + 1); 


if (bufByte == 0) { 
LOGE ("I2C: nomem") ; 
goto errl; 


} 


(*env) ->GetIntArrayRegion(env, bufArr, 0, len, bufint); 
bufByte[0] = mode; 
for (i = 0; i < len; i++) 
bufByte[i + 1] = bufint[i]; 
if ((j = write(fileHander, bufByte, len + 1)) != len * 1) ( 


LOGE("write fail in i2c"); 
goto err2; 


} 

LOGI("I2C: write %d byte", j); 

free (bufByte) ; 

free (bufint) ; 

return j - 1; 
err2: 

free (bufByte); 
erri: 

free (bufint); 
err0: 

return -1; 
#endif 


} 
JNIEXPORT void JNICALL 
Java peter amlogic serial SerialThread 0002412c close(JNIEnv *env, 


close (fileHander) ; 


jobject obj, jint fileHander, jint slaveAddr, jint mode, jintArray bufArr, jint len) 


jobject obj, jint fileHander) 


(5) 编译 i2c_elevator.c 


在 amlogicAD iic 目 录 下 运行 hdk-build, 编 译 成 功 之 后 在 libs/armeabi 


录 下 生成 libi2c_elevator.so， 代 码 如 下 所 示 。 


tony@tony-desktop:~/sda7/eclipse_dt/amlogicAD_iic ndk-build 
Invalid attribute name; 


package 
Compile thumb: i2c_elevator <= i2c elevator.c 
SharedLibrary: libi2c_elevator.so ` 
Install: libi2c_elevator.so => libs/armeabi/libi2c_elevator.so 


tony@tony-desktop:~/sda7/eclips_dt/amlogicAD_iic 


(6) 在 Java 中 调用 so 库 


1) 在 SerialThread.java 中 添加 libi2c_elevator.so， 添 加 名 称 选择 i2c_elevator。 


{ 
System. loadLibrary("i2c_elevator") ;// 


} 


2) Hava Palla Вореп(). геаа(#ЦПс1о5е() ®#@й, (КЎП РЕТ. 


public void run(){ 
// REPO 
byte[] buf = new byte[8]; 
int alaveAddr = 0xa0; 
int fileHander; 
I2c i2c = new I2c(); 
fileHander = i2c.open("/dev/i2c-1"); 
i2c.read(fileHander, slaveAddr, buf, 8); 
i2c.close (fileHander) ; 


(7) Java 调 用 jni 时 的 参数 传递 


Т) open 函 数 参数 为 注册 的 IIC 设 备 名 称 ， 类 型 为 String， 在 jni 中 打开 成 功 后 返回 一 个 文件 描述 符 。 


Java 代 码 如 下 所 示 。 


"nz 
* (iparam nodeName 

* node path name 

* @return return file hander else return <0 on fail 
* 


public native int open(String nodeName) ; 


jni 代 码 如 下 所 示 。 


JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c open(JNIEnv *env, jobject obj, jstring file) 
{ 


char fileName[64]; 
const jbyte *str; 
str = (*env)-»GetStringUTFChars (env, file, NULL); 
if (str == NULL) { 

LOGI("Can't get file name!"); 

return -1; 
} 
sprintf (fileName, "%s", str); 
LOGI ("will open i2c device node %s", fileName) ; 
(*env) ->ReleaseStringUTFChars (env, file, str); 
return open(fileName, O_RDWR); 


2) read 函 数 中 的 代码 如 下 所 示 。 


@param fileHander 
Gparam i2c adr 


Gparam buf 
Gparam Lenth 
of buf 
* @return read length 
DÀ 
public native int read( int fileHander, int 12с adr, byte buf[], int Length); 


" 
3 
8 
oO 
gp 
Ё 


read 函 数 参数 较 多 ，fileHander 为 open device 之 后 返回 的 描述 符 ;i2c_addr 为 IIC 芯 片上 要 读 取 的 地 址 ， 本 项 目 中 可 以 从 0 地 址 开始 读 ; buf0 中 存放 的 是 读 取 的 数据 。 类 型 为 byte， 因 此 在 jni 中 也 应 该 
定义 为 byte。 具 体 代码 如 下 所 示 。 


JNIEXPORT jint JNICALL 
Java peter amlogic serial SerialThread 0002412c read(JNIEnv * env, jobject obj, jint fileHander, jint slaveAddr, jbyteArray bufArr, jint len) 


Jbyte *bufint; 

Char *bufByte; 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/... 
} 


GetByteArrayRegion: 获得 byte[] 类 型 的 参数 ， 在 字 节 数组 buf 中 取 长 度 为 len 的 数据 ， 并 将 这 些 数据 传递 到 bufint 数 组 中 。 


SetByteArrayRegion: 正好 相反 ， 将 bufint 数 组 中 取 长 度 为 len 的 数据 ， 并 将 这 数据 传递 到 bufArr 字 节 数 组 中 。 
3) close 函 数 
与 open 函 数 对 应 。 


到 此 完成 11C 总 线 驱动 程序 设计 。 


63 ”蓝牙 接口 及 驱动 程序 


6.3.1 ”蓝牙 简介 


1. 蓝 牙 基 本 概念 


蓝牙 是 无 线 数据 和 语音 传输 的 开放 式 标 准 ， 它 将 各 种 通信 设备 、 计 算 机 及 其 终端 设备 、 各 种 数字 数据 系统 ， 甚 至 家 用 电器 采用 无 线 方式 连接 起 来 。 它 的 传输 距离 为 10cm~10m， 如 果 增 加 功率 或 是 加 上 
某 些 外 设 便 可 达到 100m 的 传输 距离 。 它 采用 2.4GHz 1SM 频 段 和 调频 、 跳 频 技术 ， 使 用 权 向 纠 错 编码 、ARQ、TDD 和 基带 协议 。TDMA 每 时 隙 为 0.625hs， 基 带 符 合 速率 为 1M b/s。 蓝 牙 支持 64Kb/s 实 时 语 
音 传输 和 数据 传输 ， 语 音 编码 为 CVSD， 发 射 功率 分 别 为 ImW、2.5mW 和 100mW， 并 使 用 全 球 统一 的 48 比 特 的 设备 识别 码 。 由 于 蓝牙 采用 无 线 接口 来 代替 有 线 电缆 连接 ， 具 有 很 强 的 移植 性 ， 并 且 适 用 于 


多 种 场合 ， 加 上 该 技术 功 耗 低 、 对 人 体 危害 小 ， 而 且 应 用 简单 、 容易 实现 ， 所 以 易于 推广 。 


蓝牙 技术 的 系统 结构 分 为 三 大 部 分 : 底层 硬件 模块 、 中 间 协 议 层 和 高 层 应 用 。 底 层 硬件 部 分 包括 无 线 跳 频 (RF) 、 基 带 (BB) 和 链 路 管理 (LM) 。 无 线 跳 频 层 通过 2.4GHz 无 需 授 权 的 1SM 频 段 的 微 
波 ， 实 现 数据 位 流 的 过 滤 和 传输 ， 这 层 协议 主要 定义 了 蓝牙 收发 器 在 此 频带 正常 工作 所 需要 满足 的 条 件 。 基 带 负责 跳 频 以 及 蓝牙 数据 和 信息 帧 的 传输 。 链 路 管理 负责 连接 、 建 立 和 拆除 链 路 并 进行 安全 控 
制 。 


2. 蓝 牙 协议 栈 


蓝牙 协议 栈 的 体系 结构 由 底层 硬件 模块 、 中 间 协 议 层 和 高 端 应 用 层 三 部 分 组 成 。 


(1) 底层 硬件 模块 
组 成 : 链 路 管理 协议 (Link ManagerProtocol, LMP) 、 基 带 (Base Вапа, BB) 、 射 频 (Radio Frequency, RF) 。 


功能 : 射频 通过 2.4GHz 的 ISM 频 段 实现 数据 流 的 过 滤 和 传输 。 


基带 提供 两 种 不 同 的 物理 链 路 ， 即 同步 面向 连接 链 路 (Synchronous Connection Oriented, SCO) 和 异步 无 连接 链 路 (Asynchronous Connection Less, ACL) ， 负 责 跳 频 和 蓝牙 数据 及 信息 帧 的 
传输 ， 并 且 对 所 有 类 型 的 数据 包 提供 不 同 层次 的 前 向 纠 错 码 (Frequency Error Correction, FEC) 或 循环 元 余 度 差错 校 验 (Cyclic Redundancy Check, CRC) 。 


链 路 管理 协议 (LMP) 负责 两 个 或 多 个 设备 链 路 的 建立 和 拆除 ， 以 及 链 路 的 安全 和 控制 ， 如 鉴 权 与 加 密 、 控 制 和 协商 基带 包 的 大 小 等 ， 它 为 上 层 软件 模块 提供 了 不 同 的 访问 入 口 。 


主机 控制 器 接口 (Host Controller Interface, НСІ) 是 蓝牙 协议 中 软 硬 件 之 间 的 接口 ， 提 供 了 一 个 调用 下 层 BB、LMP、 状 态 和 控制 寄存 器 等 硬件 的 统一 命令 ， 上 下 两 个 模块 接口 之 间 的 消息 和 数据 的 
传递 必须 通过 HCI 的 解释 才能 进行 。 


(2) 中 间 协 议 层 


组 成 : 逻辑 链 路 控制 和 适 配 协议 (Logical Link Control and Adaptation Protocol，L2CAP) 、 服 务 发 现 协议 (Service Discovery Protocol, SDP) 、 串 口 仿真 协议 (或 称 线 缆 蔡 换 协 议 
RFCOMM) 、 二 进 制 电话 控制 协议 (Telephony Control protocol Spectocol, TCS) 。 


功能 : L2CAP 位 于 基带 之 上 ， 向 上 层 提供 面向 连接 的 和 无 连接 的 数据 服务 ， 它 主要 完成 数据 的 拆 装 、 服 务 质量 控制 、 协 议 的 复 用 、 分 组 的 分 割 和 重组 ， 及 组 提取 等 功能 。 


SDP 是 一 个 基于 客户 /服务 器 结构 的 协议 ， 它 工作 在 L2CAP 层 之 上 ， 为 上 层 应 用 程序 提供 一 种 机 制 来 发 现 可 用 的 服务 及 其 属性 ， 服 务 的 属性 包括 服务 的 类 型 及 该 服务 所 需 的 机 制 或 协议 信息 。 


RFCOMM 是 一 个 仿真 有 线 链 路 的 无 线 数据 仿真 协议 ， 符 合 ETSI 标 准 的 TS07.10 串 口 仿真 协议 ， 它 在 蓝牙 基带 上 仿真 RS-232 的 控制 和 数据 信号 ， 为 原先 使 用 串 行 连接 的 上 层 业 务 提供 传送 能 力 。 


TCS 定 义 了 用 于 蓝牙 设备 之 间 建 立 语音 和 数据 呼叫 的 控制 信 令 (Call Control Signalling) ， 并 负责 处 理 蓝牙 设备 组 的 移动 管理 过 程 。 


(3) 高 端 应 用 层 


组 成 : 点 对 点 协议 (Point-to-PointProtocol, PPP) 、 传 输 控制 协议 /网 络 层 协议 (TCP/IP) 、 用 户 数据 包 协 议 (User Datagram Protocol, UDP) 、 对 象 交换 协议 (Object Exchang 
Protocol, OBEX) 、 无 线 应 用 


iM (Wireless Application Protocol, WAP) 、 无 线 应 用 环境 (Wireless Application Environment, WAE) 。 


功能 : PPP 定 义 了 串 行 点 对 点 链 路 应 当 如 何 传输 因特网 协议 数据 ， 主 要 用 于 LAN 接 入 、 拨 号 网 络 及 传真 等 应 用 规范 。 


TCP/IP 和 UDP 定 义 了 因特网 与 网 络 相关 的 通信 及 其 他 类 型 计算 机 设备 和 外 围 设备 之 间 的 通信 。 


OBEX 支 持 设备 间 的 数据 交换 ， 采 用 客户 /服务 器 模式 提供 与 HTTP ( 超 文本 传输 协议 ) 相同 的 基本 功能 。 可 用 于 交换 的 电子 商务 卡 、 个 人 日 程 表 、 消 息 和 便条 等 格式 。 


WAP 用 于 在 数字 蜂窝 电话 和 其 他 小 型 无 线 设 备 上 实现 因特网 业务 ， 支 持 移动 电话 浏览 网 页 、 接 收 电子 邮件 和 其 他 基于 因特网 的 协议 。 


WAE 提 供用 于 WAP 电 话 和 个 人 数字 助理 (Personal Digital Assistant, PDA) 所 需 的 各 种 应 用 软件 。 


6.3.2 Android 系统 下 的 蓝牙 架构 


在 Android 系 统 中 ， 蓝 牙 的 基本 层次 结构 如 图 6-31 所 示 。 


Java 框 架 层 android.bluetooth 包 
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蓝牙 驱动 程序 (UART,USB 等 ) 


图 6-31 Android 下 蓝牙 的 基本 结构 


从 图 6-31 可 知 蓝牙 系统 作为 Android 中 的 一 个 子 系统 ， 从 上 到 下 包含 了 多 层 的 内 容 ，Android 蓝 牙 基本 层次 如 下 : 


1. 应 用 层 


在 Android 系 统 中 蓝牙 的 相关 设置 部 分 在 Android 的 Setting 包 中 ， 路 径 为 : /packages/apps/settings/。 


蓝牙 的 应 用 部 分 opp 和 pbap 通 过 obex 库 和 蓝牙 的 RFCOM M 协 议 实 现 ， 路 径 为 : /packages/apps/Bluetooth, 


2.Java 框 架 层 


Bluetooth 的 服务 负责 管理 底层 的 本 地 服务 ， 并 封装 成 为 服务 android.bluetooth 包 中 的 一 部 分 API 提 供给 应 用 程序 ， 其 程序 代码 路 径 为 : frameworks\base\core\java\android\bluetooth, 
3. 蓝 牙 的 JNI 层 
该 层 为 提供 android.bluetooth 包 的 几 个 类 和 服务 ， 最 终 编 译 成 Android 的 jni 库 libandroid_runtime.So 中 的 一 个 部 分 ， 程 序 代 码 路 径 为 : /frameworks/base/core/jni/。 


4 .蓝牙 的 适 配 库 


包括 蓝牙 一 些 相关 的 工具 和 库 ， 主 要 功能 是 管理 蓝牙 设备 ， 如 电源 管理 操作 ， 程 序 代码 路 径 为 : system/bluetooth, 
5.Bluez 库 
Bluez 库 是 Android 下 蓝牙 的 核心 部 分 ，Android 的 上 层 移 植 主要 以 其 为 中 心 进行 ， 程 序 代码 路 径 为 : external/Bluetooth/。 最 终 编译 生成 libluetooth.so。 


6. 蓝 牙 的 驱动 程序 与 协议 层 


蓝牙 系统 的 核心 部 分 有 两 个 层次 ,分 别 是 蓝牙 驱动 程序 和 蓝牙 的 协议 层 。 其 中 蓝牙 协议 的 实现 代码 在 内 核 代码 kernel/net/bluetooth 中 ,包括 hci、l2cap、hid、rfcomm、sco、SDP、BNEP 等 协议 的 
实现 。 蓝 牙 驱 动 程序 在 kernel/driver/bluetooth 中 ， 包 含 Linux kervel 对 各 种 接口 的 Bluetooth device 的 驱动 ， 包 括 USB 接 口 、 串 行 接口 等 。 


6.3.3 ”蓝牙 驱动 程序 设计 
在 Android 系 统 中 已 经 实现 了 蓝牙 的 架构 ， 现 在 通过 Android 提 供 的 API 来 实现 可 控制 的 蓝牙 ， 蓝 牙 驱 动 程序 设计 步骤 如 下 。 
(1) 新 建 工程 项 目 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 图 6-32 所 示 的 菜单 。 


2) 在 弹出 菜单 中 选择 “new”-> “Project”， 如 图 6-33 所 示 。 


弹出 如 图 6-34 所 示 的 窗口 。 
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E 


= Сору Qualified Name 


Paste 
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6-33 ”新 建 工程 项 目 
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图 6-34 ”新 建 工程 项 目 窗口 


3) 选择 “Android”->“Android Project”， 点 击 “next” 按 钮 ， 弹 出 如 图 6-35 所 示 的 窗口 ， 在 相应 位 置 填 入 信息 。 


© New Android Project 


New Android Project 


Creates а new Android Project resource. 


А È apk_workspace/9_29/Blue 


O Create project from existing sample 


Samples: This target has 1 sampl 


Duild Ta get 


Target Name Vendor Platform 
Anuk vid 2.1 upd.. Aml vid Open Project 
C] Google APIs Google Inc. 
[] Android 2.2 Android Open Project 
F] Geogle APTe Geogle Tne 
Г] Android 2.3.1 Android Open Project 
[ | Google APIs Google Inc. 
[C] Android 2.3.3 Android Open Project 
[] Google APIs Google Inc. 
C] Android 3.0 Android Open Project 
E] Google APIs Google Inc. 
[] Android 3.1 Android Üpen Project 
[] Google APIs Google Inc. 
[] Android 3.2 Android Open Froject 
C] Google АРІ5 Google Inc. 


РЬ Б ges 


: 
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Properties 


Application name: 


Package name: | dmat ek. xch. bluetooth 


[V]Create Activity: BluetoothActivity 
Min SDK Version: I7 


v 


6-35 填写 信息 内 容 窗口 


4) 点 击 “Finish” 按 钮 完成 创建 。 
(2) 新 建 一 个 共享 类 


Т) 在 菜单 中 选择 “new”-> “Class”， 如 图 6-36 所 示 。 


B 165 BluetoothTest 
5-08 sre 


“EA Android 2. 


es assets 


8-85 res 


Open Type Hierarchy 
Show In 


96-36 ”新 建 共享 类 


2) 点 击 “Next” 按 钮 ， 弹 出 如 图 6-37 所 示 的 窗口 ， 在 相应 位 置 填 入 信息 。 


Hew Java Class 


Java Class 


Create a new Java class. 


Source folder: BluetoothTest/sre 
Package: dmatek. xch. bluetooth 
ПЕ а tí 


Name: Shar eDat ај 
Modifiers: (9) public © default 
C] abstract а final 


Superclass: ma lang. Object a: 


L 


Which method stubs would you like to create? 
[C] public static void main(String[] args) 
[C] Constructors from superclass 


[7] Inherited abstract methods 
Do you want to add comments? (Configure templates and default value here) 


[ ]Generate comments 


Ө, 


6-37 填写 共同 类 的 内 容 


3) 点 击 “Finish” 按 钮 ， 新 建 一 个 共享 类 。 


4) 编辑 这 个 文件 ， 添 加 成 员 。 


import android.bluetooth.BluetoothDevice; 
public class ShareData 

{ 

public static final int MAX BT COUNTS = 10; 
public static int current BT device count = 0; 
public static BluetoothDevice BTdevice[] = new 
BluetoothDevice [МАХ BT COUNTS]; 

} 


(3) 编写 main.xml 文 件 


main.xml 文 件 的 程序 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<RelativeLayout 

android: id="@+id/RelativeLayout01" 

android: layout_width="fill parent" 

android: layout height-"fill parent" 
xmlns:android-"http:// schemas.android.com/apk/res/android"> 
«Button android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:id-" @+id/Button | SearchBT" 
android:text-"Search ВТ" 
android:textSize-"20px" 

android:layout centerHorizontal-"true" 

> 

</Button> 

<ListView 

android: layout_below="@id/Button_SearchBT" 
android: id="@+id/ListView_BT" 

android: layout_width="fill parent" 
android:background="#FFFFFE" 

android:layout height-"fill parent" 


android: layout_above="@+id/Button_Start" 
> 

</ListView> 

</RelativeLayout> 


main.xml 文 件 定义 了 两 个 控件 的 相对 布局 ， 一 个 控件 用 来 开启 蓝牙 扫描 功能 ， 另 一 个 用 来 显示 扫描 到 的 蓝牙 设备 。 


(4) 为 Listview 添 加 一 个 布局 文件 


Т) 在 菜单 中 选择 “new”-> “File”， 如 图 6-38 所 示 。 


2) 弹出 如 图 6-39 所 示 的 窗口 ， 添 加 一 个 布局 文件 名 称 。 


0 


3) 编辑 xml 文 件 ， 输 入 如 下 内 容 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<RelativeLayout 

android: id="@+id/RelativeLayout01" 
xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:layout height-"wrap content" 

android:layout width-"fill parent" 

> 

<TextView 

android: layout_height="wrap_content" 

android: textSize="24px" > 

android: text="FEFE" 

android: layout_width="fill parent" 
android:gravity-"center vertical|center horizontal" 
android:id="@+id/listitem TextView BTName" 
android:textColor-"4000000"» Ыы 

</TextView> 

<TextView 

android: layout_height="wrap_content" 

android: text="6410XP" fa 
android:gravity-"center vertical|center horizontal" 
android:layout width-"fill parent" Е 

android: id="@+id/listitem_TextView_BTMAC" 
android:textSize-"l4px" С n 

android: layout_below="@+id/listitem_TextView_BTName" 
> 

</TextView> 

</RelativeLayout> 
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图 6-38 ”为 Listview 添 加 一 个 布局 文件 


E) OPa 
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Create a new file resource 


Enter or select the parent folder: 
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图 6-39 ”输入 布局 文件 的 内 容 


这 里 有 两 个 控件 的 相对 布局 文件 ， 一 个 控件 用 于 显示 扫描 出 的 蓝牙 的 名 字 ， 另 一 个 控件 用 于 显示 扫描 出 的 蓝牙 的 物理 地 址 。 


(5) 编辑 BluetoothActivityjava 文 件 


1) 导入 需要 的 类 : 


import java.util.ArrayList; 

import java.util.HashMap; 

import android.app.Activity; 

import android.bluetooth.BluetoothAdapter; 
import android.bluetooth.BluetoothDevice; 
import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.content.IntentFilter; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.widget.Button; 

import android.widget.ListView; 

import android.widget.SimpleAdapter; 


2) 定义 控件 及 成 员 : 


Button m_Button_SearchBT; 
ListView m_ListView_BT; 


3) 初始 化 控件 及 成 员 : 


m Button SearchBT = (Button) findViewById(R.id.Button_SearchBT) ; 
m ListView BT = (ListView) findViewByld(R.id.ListView_BT) ; 


4) 为 按钮 增加 监听 事件 : 


m_Button_SearchBT.setOnClickListener (m_Button_SearchBT Listener); 


5) 注册 一 个 不 同 过 滤器 的 事件 接收 者 : 


IntentFilter filter = new 

IntentFilter (BluetoothDevice.ACTION FOUND); 
registerReceiver (mReceiver, filter); 

filter = new 

IntentFilter(BluetoothAdapter.ACTION DISCOVERY FINISHED); 
registerReceiver (mReceiver, filter); 


6) 定义 这 个 事件 的 接收 者 : 


BroadcastReceiver mReceiver = new BroadcastReceiver () 


public void onReceive (Context context, Intent intent) 
{ 
String action = intent.getAction(); 
if (BluetoothDevice.ACTION FOUND.equals(action)) // 找到 设备 
{ 
BluetoothDevice device = 
intent.getParcelableExtra (BluetoothDevice.EXTRA DEVICE); 
{ 
boolean update = false; 
boolean add = true; 
for(int i-0; i«SharedData.current BT device count; i++) 
{ 
if (device.getAddress () .equals (SharedData.BTdevice[i] .getAddress () ) ) 


{ 
// MAC 地 址 一 样 ， 不 添加 
add = false; 
if (device.getName() != null 
&& ! (device.getName () . equals (SharedData.BTdevice[i] .getName ()))) 


{ 
// MRC 地 址 一 样 ， 名 称 不 一 样 ， 更 新 列表 
update = true; 
} 
break; 
} 


} 
if (add) 


T 

// 添加 设备 ， 更 新 列表 

update = true; 
SharedData.BTdevice[SharedData.current BT device count++] =device; 


} 
if (update) 
{ 
UpdateBTList (); 


Log.v("", "find device:" + device.getName() + 

device.getAddress ()); 

} 

} 

else if 

(BluetoothAdapter .ACTION_DISCOVERY_FINISHED.equals(action)) // 搜索 完成 
{ 


Log.v("", "find over"); 
m Button SearchBT.setEnabled (true); 
UpdateBTList(); 


setTitle (" 蓝 牙 搜索 结束 ! "); 
m_ListView_BT.setEnabled (true); 
} 


H 


7) 定义 按钮 监听 事件 : 


private Button.OnClickListener m Button SearchBT Listener = new 
Button.OnClickListener () ú B Е 
{ 
GOverride 
public void onClick(View v) 
{ 
// TODO Auto-generated method stub 
SharedData.current_BT_device_count = 0; 
UpdateBTList () ; 
BluetoothAdapter m BTAdapter; 
m BTAdapter = BluetoothAdapter.getDefaultAdapter () ; 
if (m_BTAdapter.startDiscovery () ) 
{ 


setTitle("EARF RFR, iA Rhttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/..."); 
m Button SearchBT.setEnabled (false); 
m ListView BT.setEnabled(false); 
} 
else 


{ 
setTitle (" 搜 索 蓝 牙 失 败 ! 请 确认 是 否 打开 系统 蓝牙 ! "); 
} 


H 


8) 添加 Listview 更 新 方法 : 


void UpdateBTList () 


{ 

// 生成 动态 数组 ， 加 入 数据 
ArrayList<HashMap<String, Object>> listItem = new 
ArrayList<HashMap<String, 
Object»»(); 
for(int i-0;i«SharedData.current BT device соџпі;і++) 

{ 

HashMap<String, Object> map = new HashMap<String, Object>(); 


map.put ("ItemBTName", SharedData.BTdevice[i] .getName ()); 
map.put ("ItemBTMAC", SharedData.BTdevice[i].getAddress ()); 
listItem. add (map); 


} 
// 生成 适配器 的 Ttem 和 动态 数组 对 应 的 元 素 
SimpleAdapter listItemAdapter = new SimpleAdapter(this,listItem,// 数据 源 
R.layout.listitem,// ListItem 的 XML 实现 
// 动态 数组 与 lImageItem 对 应 的 子 项 
new String[] {"ItemBTName", "ItemBTMAC"}, 
// ImageItem 的 XML 文件 里 面 的 一 个 ImageViewy, 两 个 TextView ID 
new int[] (R.id.listitem TextView BTName, 
» id.listitem TextView BTMAC) Е 


/ ; 添加 并 且 显示 
m_ListView_BT.setAdapter (listItemAdapter) 7 
} 


(6) 在 Androidmanifest.xml 中 增加 一 些 相 应 的 权限 。 


<uses-permission 
android:name-"android.permission.BLUETOOTH ADMIN" /> 
<uses-permission android:name-"android.permission.BLUETOOTH" /» 


到 此 完成 蓝牙 驱动 程序 设计 。 


测试 编写 的 蓝牙 程序 步骤 如 下 : 


Т) 把 设计 中 的 工程 目录 下 的 APK 复 制 到 SD 卡 下 ; 安装 测试 系统 蓝牙 ， 把 连接 蓝牙 ， 点 击 安装 好 的 APK， 如 


BluetoothTest 


Speech Recorder 


2) Huh "Search BT" 按钮 ， 如 图 6-41 所 示 。 


[R] 


6-40 所 示 。 


CenBusSystem |. Demo Ultrasor ic Dev Too s 


6-40 ”点 击 安装 好 的 APK 


КАШ "Search BT” 按 钮 进行 蓝牙 扫描 ， 过 一 会 儿 就 能 扫描 出 附近 的 蓝牙 设备 ， 如 


图 


6-42 所 示 。 
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图 6-41 SÆ “Search BT” 按 钮 进行 蓝牙 扫描 
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图 6-42 ”蓝牙 扫描 结果 


3) 如 果 扫 描 中 按钮 变 成 不 使 能 ， 扫 描 完成 后 提示 标题 。 如 果 没有 打开 蓝牙 会 提示 。 


64 Wi-Fi 接 口 及 通信 程序 


在 DMA-210XP 实 验 平台 上 插入 Wi-Fi+BT+FM 三 合 一 无 线 网 卡 ， 编 写 Android 的 Wi-Fi 测 试 程序 。 实 现 打开 Wi-Fi， 在 LCD 右 上 角 出 现 Wi-Fil 
失 ， 关 闭 Wi-Fi。 


6441 Wi-Fi 介 绍 


1.Wi-Fi 简 介 


标 ， 连 接 Wi-Fi。 关 闭 Wi-Fi， 在 LCD 右 上 角 


的 Wi-Fi 


标 消 


所 谓 Wi-Fi， 是 由 一 个 名 为 “无 线 以 太 网 兼容 联盟 ” (Wireless Ethernet Compatibility Alliance, МЕСА) 的 组 织 所 发 布 的 业界 术语 ， 中 文 译 为 “无 线 兼 容 认证 ”。 它 是 一 种 短程 无 线 传输 技术 ， 能 够 


在 数 百 米 范 围 内 支持 互联 网 接 入 的 无 线 电 信号 ， 人 们 也 称 Wi-Fi 为 无 线 宽带 。Wi-Fi 是 可 以 将 个 人 计算 机 、 手 持 设备 (如 PDA、 手 机 ) 等 终端 以 无 线 方式 互相 连接 的 技术 。Wi-Fi 主 要 涉及 的 协议 基于 IEEE 
802.11 标 准 。 


2.Android 下 的 Wi-Fi 


Android 系 统 主要 的 连接 部 分 包括 Wi-Fi、 蓝 牙 及 GPS 定 位 ， 作 为 连接 部 分 来 说 ，Wi-Fi 的 使 用 变 得 越 来 越 广泛 。 下 面 将 介绍 Android 下 Wi-Fi 子 系统 的 流程 和 基本 框架 。Wi-Fi 在 Android 中 的 系统 架构 如 
图 6-43 所 示 。 


从 图 6-43 可 知 ，Wi-Fi 与 其 他 Android 下 的 子 系统 一 样 涉及 很 多 方面 ， 下 面 将 介绍 Android 系 统 中 Wi-Fi 原 始 程 序 代 码 。Android 的 Wi-Fi 部 分 从 上 到 下 包含 以 下 内 容 。 


Java); HE 


ЈауаћЕ B J android.net.wifi{y, 


Wi-Fi 的 jni 部 分 


WPA Nc air 


уура ѕиррісапі Ё y 


核心 空间 Wi-Fi 的 核心 驱动 程序 


图 6-43 Android 下 Wi-Fi 的 基本 层次 架构 


(1) Wi-Fi 的 相关 应 用 程序 


典型 的 Wi-Fi 应 用 程序 如 系统 的 Settings 中 的 Wi-Fi 部 分 ， 用 于 为 用 户 提供 相应 的 图 形 应 用 接口 ， 使 系统 设置 更 加 的 人 性 化 。 系 统 中 的 Settings 实 现 的 程序 代码 路 径 在 
packages/apps/Settings/src/com/android/settings/wifi, 


(2) Wi-Fi 的 jni 部 分 


Android 中 Wi-Fi 系 统 的 jni 部 分 实现 的 程序 代码 路 径 如 下 : 


frameworks/base/core/jni/android_net_wifi_Wifi.cpp 


通过 Wpa_supplicant 泛 配 层 的 头 文件 wifi.h 获 取 适 配 层 定义 的 接口 ， 最 终 实现 Wi-Fi 与 底层 接口 的 连接 。 


(3) Wi-Fi 的 Java 框 架 部 分 


这 部 分 是 Android 中 为 Wi-Fi 提 供 服务 和 对 上 层 提供 接口 的 部 分 ， 这 部 分 内 容 相关 的 程序 代码 路 径 如 下 : 


frameworks/base/services/java/com/android/server/ 


这 部 分 是 Wi-Fi 服 务 层 的 内 容 ， 是 控制 Wi-Fi 在 Java 层 通信 的 内 核 部 分 。framework/base/wifi/java/android/net/wifi/WiFi 部 分 的 接口 ， 也 是 对 上 层 应 用 提供 的 接口 。 


(4) WPA 适 配 层 


这 部 分 是 系统 Wi-Fi 移 植 时 的 重要 部 分 ， 这 一 部 分 是 通 上 


框架 使 用 。 其 在 系统 原始 程序 代码 中 的 相关 程序 码 路 径 如 下 : 


“WPA 适 配 层 的 头 文件 路 径 如 下 : 


wpa_supplcant 的 封装 ， 在 Android 中 作为 Wi-Fi 的 硬件 抽象 层 来 使 用 。 主 要 功能 是 实现 与 wpa_supplicant 守 护 线程 的 通信 ， 提 供给 Android 的 


hardware/libhardware legacy/include/hardware legacy/wifi.h 


“WPA 适 配 层 的 原始 程序 代码 路 径 如 下 : 


hardware/libhardware_legacy/wifi 


(5) wpa_supplicant 程 序 


Android 的 Wi-Fi 部 分 本 地 实现 包含 wpa_supplicant 以 及 WPA 适 配 层 。wpa_supplicant 是 一 个 开源 项 目 ， 是 Wi-Fi 的 工 


式 系统 中 ， 其 原始 程序 代码 路 径 如 下 : 


， 它 比 Wi-Fi 的 其 他 功能 更 加 强大 ， 已 移植 到 大 部 分 Linux、Windows 以 及 嵌入 


external/wpa_supplicant 


这 个 工程 的 内 容 编 译 成 动态 链接 库 libwpa_client.so 和 可 执行 程序 wpa_supplicant。 


wpa_supplicant 这 个 程序 是 可 独立 执行 的 程序 ， 其 内 核 内 容 是 一 个 信息 循环 。 下 面 介 绍 wpa_supplicant 应 用 程序 的 一 些 通用 命令 。 经 过 编译 后 的 wpa_supplicant 源 程序 可 以 看 到 两 个 主要 的 可 执行 工 


络 方式 如 下 : 


“ 执行 wpa_supplicant 程 序 。 


А: wpa_supplicant 和 wpa_cli。wpa_supplicant 是 内 核 程序 ， 它 和 wpa_cli 的 关系 就 是 服务 器 和 客户 端的 关系 : 后 台 执行 wpa_supplicant， 使 用 wpa_cli 来 搜索 、 设 置 和 连接 网 络 。wpa_cli 的 一 些 连 接 网 


/system/bin/wpa_supplicant -d -Dwext -iwlan0 
-c/data/misc/wifi/wpa supplicant.conf 


其 中 : 
-d: 增加 调试 信息 
-Dwext: wext， 驱 动 名 称 


-iwlan0: wlan0， 网 络 接口 名 称 


/system/bin/wpa_supplicant: wpa_supplicant 可 执行 程序 路 径 


/data/misc/wifi/wpa_supplicant.conf: wpa_supplicant 的 配置 文件 路 径 


` 执行 命令 行 工具 wpa_cli。 


мра cli -iwlan0 -p/data/system/wpa supplicant 


注意 : -p/data/system/wpa_supplicant 中 的 wpa_supplicant 并 不 是 可 执行 程序 ， 而 是 个 控制 套 接 字 。 


some common command: 
>scan = to scan the neighboring AP 
>scan_results = show the scan results 


>status = check out the current connection information 


>terminate = terminate wpa_supplicant 
>quit = exit wpa_cli 


>add_network = it will return a network id to you 
>set_network <network id> <variable> <value> = set network variables 
(shows list of variables when run without arguments), success will 


return OK, or will return Fail 


>select_network <network id> = select a network (disable others) 
>disable_network <network id> = disable a network 


>enable_network <network id> = enable a network 
> set_network 0 priority 0 

> list network 

> save_config 


wpa_supplicant 的 驱动 类 型 很 多 ，DMA-210XP 上 使 


的 驱动 是 wext 类 型 ， 具 体 的 程序 代码 路 径 如 下 所 示 : 


device\samsung\proprietary\wpa_supplicant_lib 


(6) Wi-Fi 的 驱动 部 分 


Wi-Fi 驱 动 部 分 是 直接 调 上 


Wi-Fi 的 硬件 设备 ， 不 同 的 设备 使 用 不 同 的 驱动 ， 一 般 内 核 中 的 Wi-Fi 驱 动 涉及 以 下 两 个 方 


“Wi-Fi 使 用 的 协议 部 分 ， 内 核 程序 代码 路 径 如 下 : 


Kernel/net/wireless/ 


"Wi-Fi 的 驱动 部 分 ， 内 核 程序 代 码 路 径 如 下 : 


Kernel/drivers/net/wireless/ 


Android 下 的 Wi-Fi 基 本 原理 介绍 到 这 里 ， 下 面 介绍 如 何 对 Wi-Fi 进 行 控制 。 
64.2 ”Wi-Fi 程 序 设 计 

在 设计 之 前 ， 通 过 之 前 的 实验 原理 可 知 ， 在 Android 系 统 中 已 经 实现 了 Wi-Fi 的 架构 ， 现 在 通过 Android 提 供 的 APl 来 实现 自己 控制 的 Wi-Fi， 设 计 步骤 如 下 。 
1. 新 建 工程 项 目 


1) 在 Eclipse 中 新 建 一 个 工程 ， 右 击 Package Explorer 的 空白 处 ， 弹 出 如 图 6-44 所 示 菜 单 。 


2) 在 弹出 菜单 中 选择 “New” 一 “Project”， 如 图 6-45 所 示 。 


New k 
Show In AlttShifttW P 


Copy CtrliC 
ES Copy Qualified Name 

Paste CtrltV 
A Delete Delete 
ry import... 

т^ Export... 


Qm Refresh 
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| Project... 
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Ж Delete Delete 


图 6-45 ”新 建 工程 项 目 


弹出 如 图 6-46 所 示 窗 口 。 


3) 选择 “Android” 一 “Android Project”， 点 击 “Next” 按 钮 ， 弹 出 如 图 6-47 所 示 窗 口 ， 在 相应 位 置 填 入 信息 。 
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86-46 新 建 工程 项 目 窗口 
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图 6-47 ”填写 信息 内 容 窗口 


4) 点 击 “Finish” 按 钮 完成 创建 。 
2. 编 写 string.xml 文 件 


xml 文 件 的 程序 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«resources» 

«string name="hello">Hello World, EX05 17«/string» 

«string name="app_name">Wi-fiTest</string> 

«string name-"str checked"> 开 启 Wi-Fi</string> 

<string name-"str uncheck"»XH]Wi-Fi«/string» 

«string name-"str start wifi failed"> 举 试 开局 Wi-Fi 服务 失败 
</string> 

«string name="str_start_wifi_done">Zik#-@Wi-Fi 服务 成 功 </string> 
<string name="str stop wifi failed"> &HIWi-Fi 服务 失败 </string> 

<string name="str stop wifi done"> Wi-Fi 服务 成 功 </string> 

«string name-"str wifi enabling">Wi-Fi 启用 过 程 中 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...«/string» 
<string name-"str wifi disabling">Wi-Fi 关闭 过 程 中 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...</string> 
<string name="str wifi disabled">Wi-Fi 已 经 关闭 </string> = 

<string name-"str wifi unknow"2Wi-Fi ЖАК Һер: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/...</string> 
</resources> 


3. 建 立 colorxml 文 件 


1) 在 项 目 文件 列表 中 右 击 values， 弹 出 如 图 6-48 所 示 菜 单 。 在 弹出 菜单 中 选择 “New” > "File" , 


2) 弹出 一 个 如 图 6-49 所 示 窗 口 。 填 写 相应 信息 后 ， 点 击 “Finish” 按 钮 完成 创建 。 
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图 6-48 建立 一 个 文件 
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6-49 ”创建 color.xml 文 件 


colorxml 中 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<resources> 

<drawable name="darkgray">#808080</drawable> 
<drawable name="white">#FFFFFF</drawable> 
<drawable name="blue">#0000FF</drawable> 
<drawable name="black">#000000</drawable> 
</resources> 


4. 编 辑 main.xml 文 件 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:background="@drawable/black" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android: id="@+id/myTextViewl" 
android: layout_width="fill_parent" 
android:layout height-"wrap content" 
android: textColor="@drawable/blue" 
` M 

> 
<CheckBox 
android: id="@+id/myCheckBox1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: text="@string/str_checked" 
кечле тенек 

> 
</LinearLayout> 


这 个 布局 文件 定义 了 两 个 控件 。 


5. 编 写 WifiActivity 类 


导入 需要 的 类 ， 代 码 如 下 : 


import android.app.Activity; 

import android.content.Context; 
import android.net.wifi.WifiManager; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.widget .CheckBox; 
import android.widget.TextView; 
import android.widget.Toast; 


6. 定 义 控件 及 成 员 


private TextView mTextView01; 
private CheckBox mCheckBox01; 
private WifiManager mWiFiManager01; 


7. 初 始 化 控件 及 成 员 


mTextView01 
mCheckBox01 


(TextView) findViewById (R.id.myTextViewl); 
(CheckBox) findViewById (R.id.myCheckBoxl); 


8 .获取 Wi-Fi 管 理 服务 


mWiFiManager01 = (WifiManager) 
this.getSystemService (Context.WIFI SERVICE); 


9 判断 Wi-Fi 是 否 使 能 ， 并 做 相应 处 理 


if (mWiFiManager01.isWifiEnabled()) 

{ if(mWiFiManager0l.getWifiState()--WifiManager.WIFI STATE ENABLED) 
{ 

mCheckBox01.setChecked (true) ; 
mCheckBox01.setText (R.string.str_uncheck) ; 
} 

else 

{ 

mCheckBox01.setChecked (false); 
mCheckBox01.setText (R.string.str_checked) ; 
} 

} 

е1зе 


{ 

mCheckBox01.setChecked (false); 
mCheckBox01.setText (R.string.str_checked) ; 
} 


10. 添 加 checkbox 的 


件 监听 与 处 理 


mCheckBox01.setOnClickListener (new CheckBox.OnClickListener () 


GOverride 
public void onClick(View v) 


{ 

if (mCheckBox01.isChecked () ==false) 
{ 

try 


{ 
if (mWiFiManager01.isWifiEnabled() ) 


{ 

if (mWiFiManager01.setWifiEnabled (false) ) { 
mTextView01.setText (R.string.str_stop_wifi_done); 
] 

else 


mTextView01.setText (R.string.str_stop_wifi_failed); 
} 

} 

else 

{ 

switch (mWiFiManager01.getWifiState () ) 


case WifiManager.WIFI_STATE ENABLING: 
mTextView01.setText (getResources () . 
getText (R.string.str_stop_wifi_failed)+ 
getResources ().getText(R.string.str wifi enabling 

); 

break; 

case WifiManager.WIFI STATE DISABLING:mTextView01.setText ( 
getResources ().getText(R.string.str stop wifi failed)+":"+ 
getResources ().getText(R.string.str wifi disabling)); 
break; Ы = 

case WifiManager.WIFI STATE DISABLED: 

mTextView01.setText (getResources () .getText 

(R.string.str stop wifi failed)+":"+ 

getResources ().getText(R.string.str wifi disabled)); 
break; 

case WifiManager.WIFI STATE UNKNOWN: 

default: B 

mTextView01.setText (getResources () .getText ( 

R.string.str stop wifi failed)+":"+ 

getResources ().getText(R.string.str wifi unknow)); 

break; } 

mCheckBox01.setText (R.string.str_checked) ; }} 

catch (Exception e) { 

Log.i("HIPPO", e.toString()); 

e.printStackTrace();]) 

else if (mCheckBox01.isChecked ()==true) 

{ 

try 


{ 

if (!mWiFiManager01.isWifiEnabled() && 
mWiFiManager01.getWifiState() != 
WifiManager.WIFI_STATE ENABLING ) 

{ 

if (mWiFiManager01.setWifiEnabled (true) 
{ 

switch (mWiFiManager01.getWifiState () ) 


{ 

case WifiManager.WIFI_STATE ENABLING: 
mTextViewO0l.setText( ` 

getResources ().getText(R.string.str wifi enabling) 

); 

break; 

case WifiManager.WIFI_STATE ENABLED: 
mTextViewOl.setText ( 

getResources ().getText(R.string.str start wifi done)); 
break; Е 
default: 

mTextView01.setText ( 
getResources().getText(R.string.str start wifi failed) +":"+ 
getResources ().getText(R.string.str wifi unknow) 


); 
break; } } 
else 


mTextView01.setText (R.string.str_start_wifi_failed); 

} 

} 

е1зе 

{ 

switch (mWiFiManager01.getWifiState () ) 

{ 

case WifiManager.WIFI_STATE ENABLING: 

mTextView01.setText ( `” Е 

getResources () .getText (R.string.str_start_wifi_failed)+":"+ 
getResources () .getText (R.string.str_wifi_enabling) 

); 

break; 

case WifiManager.WIFI_STATE DISABLING: 
mTextView01.setText ( 5 
getResources().getText(R.string.str start wifi failed)+" 
getResources ().getText(R.string.str wifi disabling) 

); 

break; 

case WifiManager.WIFI STATE DISABLED: 
mTextViewO0l.setText( `” T 

getResources () .getText (R.string.str_start_wifi_failed)+" 
getResources () .getText (R.string.str wifi disabled) 

); 

break; 

case WifiManager.WIFI STATE UNKNOWN: 

default: Е Е 

mTextView01.setText ( 

getResources () .getText (R.string.str_start wifi Ғаі1еа) +" 
getResources () .getText (R.string.str_wifi_unknow) 

); 

break; 

} 


} 
mCheckBox01.setText (R.string.str_uncheck) ; 


catch (Exception e) 

{ 

Log.i("Errors", e.toString()); 
e.printStackTrace(); 

13D; 


11. 添 加 toast 处 理 方法 


public void mMakeTextToast (String str, boolean isLong) 
{ 

if (isLong==true) 

{ 

Toast.makeText (WifiActivity.this, str, 

Toast .LENGTH LONG) . show () ; 

} 

else{ 

Toast.makeText (WifiActivity.this, str, 

Toast .LENGTH SHORT) . show () ; }} 


12. 重 写 OnResume 方 法 


GOverride 

protected void onResume () 
{ 

try 


switch (mWiFiManager01.getWifiState () ) 

{ 

case WifiManager.WIFI STATE ENABLED: 
mTextView01.setText ( > 

getResources () .getText (R.string.str_ wifi enabling) ); 
break; e Е 

case WifiManager.WIFI STATE ENABLING: 
mTextView01.setText ( Е 

getResources ().getText(R.string.str wifi enabling)); 
break; 

case WifiManager.WIFI STATE DISABLING: 
mTextViewO0l.setText( ` 

getResources ().getText(R.string.str wifi disabling)); 
break; 

case WifiManager.WIFI STATE DISABLED: 
mTextView0l.setText( `” T 

getResources () .getText (R.string.str wifi disabled)); 
break; > a 

case WifiManager.WIFI STATE UNKNOWN: 

default: Е Е 

mTextView01.setText ( 

getResources () .getText (R.string.str_wifi_unknow) ); 
break; } } ui Е 

catch (Exception е) 


{ 

mTextView01.setText (e.toString()); 
e.getStackTrace(); 

} 

super.onResume () ; } 


13. 在 Androidmanifest.xml 中 加 入 对 Wi-Fi 控 制 的 权限 


<uses-permission 

android:name-"android.permission.CHANGE NETWORK STATE"»«/uses-permission» 
«uses-permission T = 
android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission> 
<uses-permission 

android:name="android.permission.ACCESS NETWORK _STATE"></usespermission> 
«uses-permission pi p 
android:name-"android.permission.ACCESS WIFI STATE"»«/uses-permi 

ssion» 

«uses-permission 

android:name="android.permission. INTERNET"></uses-permission> 
<uses-permission 
android:name="android.permission.WAKE_LOCK"></uses-permission> 


到 此 ，Wi-Fi 的 设计 就 完成 了 。 


接 下 来 测试 Wi-Fi 程 序 ， 步 又 如 下 : 
1) 安装 APK， 把 实验 设计 工程 目录 下 的 APK 拷 贝 到 SD 卡 (安装 方法 请 看 LED 中 的 实验 步骤 ) 。 


2) 安装 测试 系统 Wi-Fi。 把 Wi-Fi 连 接 上 。 由 于 没有 进行 Wi-Fi 连 接 这 一 步 ， 因 此 无 法 输入 密码 。 


3) 点 击 如 图 6-50 所 示 的 “WifiTest” 图 标 。 出 现 如 图 6-51 所 示 界 面 。 
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6-50 ”点 击 “WifiTest” 图 标 


由 图 6-51 可 以 看 到 已 义 选 开关 Wi-Fi， 右 上 角 出 现 了 Wi-Fi 无 线 连 接 图 示 ， 表 明 Wi-Fi 已 经 连接 上 。 


去 掉 选 择 开 关 Wi-Fi， 右 上 角 的 图 示 就 消失 了 ， 如 图 6-52 所 示 。 


Wi-Fi 被 关闭 ， 再 次 点 击 选择 上 ，Wi-Fi 又 被 连接 上 ， 如 此 这 样 就 可 以 控制 Wi-Fi 了 。 


F Dua 3:54 


6-51 ”Wi-Fi 已 打开 


6-52 Wi-Fi £ X H] 


在 DMA-210XP 实 验 平台 上 设计 一 个 多 媒体 播放 器 ， 从 SD 卡 中 读 取 可 播放 的 音乐 和 视频 文件 。 编 写 Android 的 多 媒体 播放 器 程序 ， 并 将 结果 显示 在 LCD 屏 幕 上 。 


Android 是 一 个 完整 目 相对 复杂 的 系统 ， 其 中 的 一 个 MediaPlayer 功 能 无 疑 也 会 为 Android 系 统 带 来 很 大 的 影响 。 那 么 Android 系 统 如 何 实现 MediaPlayer 的 功能 呢 ? 这 主要 由 OpenCore 中 的 Player 来 


实现 ， 本 节 介 绍 Android 系 统 中 MediaPlayer 的 架构 。 


Android 的 MediaPlayer 包 含 了 Music (音频 ) 和 Video (视频 ) 的 播放 功能 ， 在 Android 的 应 用 程序 中 ，Music 和 Video 两 个 应 用 程序 都 是 通过 调用 MediaPlayer 来 实现 的 。MediaPlayer 在 底层 是 基于 
OpenCore (PacketVideo) 的 库 实现 的 ， 为 了 构建 一 个 MediaPlayer 程 序 ， 上 层 还 包含 了 IPC (进程 间 通 信 ) 等 内 容 ， 这 种 进程 间 通 信 的 基础 是 Android 基 本 库 中 的 Binder 机 制 。 


MediaPlayer 在 执行 的 时 候 ， 大 致 可 以 分 成 Client 和 Server 两 个 部 分 ， 而 且 分 别 在 两 个 进程 中 执行 。 它 们 之 间 是 通过 使 用 Binder 机 制 来 实现 |PC 通 信 的 。 从 框架 结构 上 来 看 ，IMediaPlayerService.h、 
IMediaPlayerClient.h 和 MediaPlayer.h 三 个 类 定义 了 MeidaPlayer 的 界面 和 架构 ，MediaPlayerService.cpp 和 mediaplayer.cpp 两 个 文件 用 于 MeidaPlayer 架 构 的 实现 ，MeidaPlayer 的 具体 功能 


PVPlayer ( 库 libopencoreplayer.so) 中 实现 。 


为 了 更 直观 地 展示 MediaPlayer 在 Android 系 统 中 的 架构 ， 接 下 来 简单 分 析 Android 系 统 的 原始 程序 代码 ， 帮 助 读者 了 解 MediaPlayer 在 Android 系 统 中 是 如 何 实现 的 。Android MediaPlayer 的 执行 流 
程 如 图 6-53 所 示 。 
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96-53 Android MediaPlayer 执 行 流程 图 


Android 系 统 中 涉及 MediaPlayer 的 目录 如 下 : 
` 应 用 程序 层 


Java 程 序 的 路 径 如 下 : 


本 地 调用 jni 


这 部 分 的 内 容 被 编译 成 ibmedia_jni.so 库 文件 。 


要 的 头 文件 的 路 径 如 下 : 


frameworks/base/include/media/ 


多 媒体 底层 库 的 路 径 如 下 : 


frameworks/base/media/libmedia/ 


这 部 分 的 内 容 被 编译 成 ibmedia.so 库 。 


“ 多 媒体 本 地 服务 


Java 本 地 调用 部 分 的 原始 程序 代码 文件 的 路 径 如 下 : 


frameworks/base/media/jni/android media MediaPlayer.cpp 


多 媒体 服务 部 分 原始 程序 代码 的 路 径 为 : 


frameworks/base/media/libmediaplayerservice/ 


涉及 的 原始 程序 代码 程序 为 nediaplayerservice.h 和 mediaplayerservice.cpp，Android 将 这 部 分 内 容 封 装 成 ibmediaplayerservice.so 库 。 


“ 外 部 库 ， 多 媒体 实现 部 分 


基于 OpenCore 的 多 媒体 播放 器 部 分 依赖 的 第 三 方 库 的 路 径 如 下 : 


external/opencore 


为 建立 进程 间 通 信 的 机 制 。 


2.MediaPlayer 的 主要 程序 分 析 


(1) Java 程 序 部 分 


在 packages/apps/Music/src/com/android/music/ 目 录 MediaPlaybackService.java 文 件 中 ,包含 了 对 MediaPlayer 的 调用 。 


在 MediaPlaybackService.java 中 包含 对 包 的 引用 : 


这 一 部 分 经 过 系统 编译 之 后 ， 封 装 成 libopencoreplayer.so 库 。 从 程序 规模 上 来 看 ，libopencoreplayer.so 是 MediaPlayer 主 要 依赖 的 原始 程序 代码 链接 库 ， 而 其 他 的 库 基本 上 都 是 在 其 上 建立 的 封装 和 


import android.media.MediaPlayer; 


在 MediaPlaybackService 类 的 内 部 定义 了 MultiPlayer 类 : 


private class MultiPlayer { 
private MediaPlayer mMediaPlayer = new MediaPlayer(); } 


MultiPlayer 类 中 使 用 了 MediaPlayer 类 ， 其 中 有 一 些 对 这 个 MediaPlayer 的 调用 ， 调 用 的 过 程 如 下 所 示 : 


mMediaPlayer.reset () ; 
mMediaPlayer.setDataSource (path) ; 
mMediaPlayer.setAudioStreamType (AudioManager.STREAM MUSIC) ; 


上 述 代码 中 的 这 些 方法 reset、setDataSource 和 setAudioStreamType 等 就 是 通过 Java 本 地 调用 (NI) 来 实现 的 。 


(2) jni 部 分 


MediaPlayer 的 Java 本 地 调用 部 分 在 目录 frameworks/base/media/jni/ 的 android_media_MediaPlayer.cpp 文 件 中 实现 。 它 定义 了 一 个 JNINativeMethod (Java 本 地 调 


gMethods， 代 码 如 下 所 示 : 


方法 ) 类 型 的 数组 


static JNINativeMethod gMethods[] = { 


{"setDataSource", "(Ljava/lang/String;)V", (void 

*)android media MediaPlayer setDataSource}, 

("setDataSource", "(Ljava/io/FileDescriptor;JJ)V", (void 

*)android media MediaPlayer setDataSourceFD)], 

http: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/... 
(" release", "()V", (void *)android media MediaPlayer release], 

{" reset", "()V", (void *)android media MediaPlayer reset), 


{"setAudioStreamType", "(I)V", (void 
*)android media MediaPlayer setAudioStreamType], 


http: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/... 


JNINativeMethod 的 第 一 个 成 员 是 一 个 字符 串 ， 表 示 了 Java 本 地 调用 方法 的 名 称 ， 这 个 名 称 是 在 Java 程 序 中 调用 的 名 称 ; 第 二 个 成 员 也 是 一 个 字符 串 ， 表 示 jJava 本 地 调 


成 员 是 Java 本 地 调用 方法 对 应 的 C 语 言 函 数 。 


(3) MediaPlayer 的 客户 端 libmedia.so 


MediaPlayer} 


的 客户 端 程序 libs/media/mediaplayer.cpp 文 件 用 于 实现 mediaplayer.h 提 供 的 接口 ， 其 中 一 个 重要 的 代码 片段 如 下 所 示 : 


方法 的 参数 和 返回 值 ; 第 三 个 


const sp& MediaPlayer: :getMediaPlayerService () 


Mutex::Autolock _1(mServiceLock) ; 


if (mMediaPlayerService.get() == 0) { 

sp sm = defaultServiceManager () ; 

sp binder; 

do { 

binder = sm-»getService (Stringl6 ("media.player")); 

if (binder != 0) 

break; 

LOGW("MediaPlayerService not published, waitinghttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/..."); 
usleep(500000); // 0.5 s ~ 
} while (true); 

if (mDeathNotifier == NULL) { 

mDeathNotifier = new DeathNotifier(); 


} 
binder-»linkToDeath (mDeathNotifier) ; 
mMediaPlayerService = interface_cast (binder) ; 


] 
LOGE IF (mMediaPlayerService--0, "no MediaPlayerService!"); 
return mMediaPlayerService; 


} 


其 中 最 重要 的 一 点 是 “binder=sm->getService (String16 ("media.player") ) ; ”这 个 调用 ， 用 来 得 到 一 个 名 称 为 “media.player” 的 服务 ， 这 个 调用 返回 值 的 类 型 为 1Binder， 根 据 实 现 将 其 转换 
成 类 型 IMediaPlayerService 进 行使 用 。 


(4) mediaPlayer 服 务 层 libmediaservice.so 


Android 原 始 程 序 代 码 中 frameworks/base/media/libmediaplayerservice 目 录 中 的 MediaPlayerService.h 和 MediaPlayerService.cpp 用 于 实现 一 个 servers/media/ 的 服务 ，MediaPlayerService 是 继 
承 BnMediaPlayerService 的 实现 ， 在 这 个 类 的 内 部 又 定义 了 类 Client，MediaPlayerService::Client 继 承 了 BnMediaPlayer。 


(5) MediaPlayer 实 现 部 分 


External/opencore/PacketVideo 的 OpenCore 在 Android 系 统 中 作为 多 媒体 的 实现 部 分 ， 继 承 media 库 定义 的 部 分 。 


6.5.3 ”MediaPlayer 播 放 器 程序 设计 


在 DMA-210XP 实 验 平台 上 设计 一 个 多 媒体 播放 器 ， 从 SD 卡 中 读 取 可 播放 的 音乐 和 视频 文件 。 编 写 Android 的 多 媒体 播放 器 程序 ， 并 将 结果 显示 在 LCD 屏 幕 上 。 


本 节 的 设计 不 涉及 驱动 与 jni， 只 是 调用 了 Android 的 API。Android 系 统 中 自 带 Music 播 放 器 ， 可 以 播放 音乐 文件 。 同 时 读者 也 可 以 制作 自己 喜爱 的 播放 器 来 实现 播放 音乐 和 视频 。 下 面 讲解 简单 播放 器 
的 制作 过 程 。 


1. 新 建 一 个 工程 


设 定 Android 开 发 版 本 、 项 目 名 称 与 版 本 代号 如 图 6-54 所 示 。 


© New Android Project 


New Android Project 


Creates a new Android Project resource, 


Froject name: Demo MediaPlayer 


Contents 


(S Create new project in workspace 
(Create project from existing source 


[|же default location 
D:/apk workspace/envtest/Iemo MediaPlayer 
(Create project from existing sample 


Samples: |Apillemas 


Build Target 


Target Nama Vendor Flatform AF... 
[ | Android 1.5 Android Open Source Project 
C] Android 1.6 Android Open Source Project 
Android @.l-upd... Android Open Source Project 
[| android E. Android Преп Source Project 
C] Android 2.3.3 Android Open Source Project 
C] Android 3.1 Android Open Source Project 
C] Android 3.2 Android Open Source Project 


Standard Android platform z, l-updatel 


Properties 


Application name: MediaPlayer 
Package пале: dmatek. xch. demo. mediaplayer — 
[v] Create Activity: |MedisFlayerÁctivity 


图 6-54 ”新 建 工程 


2. 上 层 UI 设 计 


建立 项 目 后 ， 接 下 来 考虑 设计 UI， 如 图 6-55 所 示 。 


图 6-55 MediaPlayer UI 


media.xml 文 件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android="http:// schemas.android.com/apk/res/android" 
android:background="#025412" 
android:orientation="vertical" 
android:layout width-"fill parent" 
android: layout_height="fill_parent"> 
<VideoView 

android: id="@+id/myVideoViewl" 
android: layout_alignParentTop="true" 
android: layout alignParentLeft-"true" 
android: layout_width="650px" 

android: layout_height="460px" 

/> 

<ImageView 

android: id="@+id/media_ pic" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerVertical-"true" 
android:layout marginLeft-"30px" 
android: src="@drawable/abc" 

/> 

<TextView 

android: id="@+id/play mode" 

android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentTop-"true" 
android:layout alignParentRight-"true" 


android:text=" 播 放 模式 " 
android: i Osp" 
android: "#000000" 
android: textColor="#00fff£" 
/> 

<TextView 


android: id="@+id/media_PlayList" 

android: layout width-"wrap content" 
android:layout height-"wrap content" 
android: layout_below="@+id/play mode" 
android: layout alignParentRight-"true" 
android:text="it wz " 

android: textSize="20sp" 

android: background="#000000" 

android: textColor="#00fff£" 

/> 

<ListView 

android:id="@+id/media list" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignLeft-"G*id/media PlayList" 
android: layout_below="@+id/media_PlayList" 
/> 

</RelativeLayout> 


在 上 述 程序 代码 中 ， 


要 包含 两 部 分 : 


© VideoView: 此 控件 可 以 显示 一 些 视频 文件 (如 mp4、3gp) ， 也 可 以 播放 音乐 文件 (mp3) , 和 content ptoviders 中 下 载 图 片 文件 ， 并 提供 多 种 显示 选择 ， 如 缩放 和 着 色 等 。 它 封装 了 播放 


一 个 视频 文件 所 需 的 函数 ， 只 要 调用 相关 的 函数 就 可 以 实现 视频 、 音 乐 播放 功能 。 


+ ListView: 在 此 应 用 程序 中 ，ListView 主 要 用 来 显示 从 SD 卡 中 读 取 的 可 用 的 视频 与 音乐 文件 。 这 个 控件 主要 在 主 程序 中 实现 。 


3.MediaPlayer.java 程 序 代码 


导入 相应 的 包 文件 : 


package dmatek.xch.mediaplayer; 
import java.io.File; 
import java.util.ArrayList; 


import java.util.List; 

import tw.com.dmatek.dma6410xp.R; 

import android.app.Activity; 

import android.app.AlertDialog; 

import android.app.Dialog; 

import android.content.Context; 

import android.content.DialogInterface; 

import android.graphics.PixelFormat; 

import android.media.MediaPlayer.OnCompletionListener; 
import android.media.MediaPlayer.OnPreparedListener; 
import android.net.Uri; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 

import android.widget.AdapterView; 

import android.widget.ArrayAdapter; 

import android.widget.ImageView; 

import android.widget.ListView; 

import android.widget.MediaController; 

import android.widget.TextView; 

import android.widget.Toast; 

import android.widget.VideoView; 

import android.widget .AdapterView.OnItemClickListener; 


让 MediaPlayer 继 承 Activity: 


public class MediaPlayer extends Activity{ 


定义 变量 及 成 员 : 


private VideoView mVideoView01; 

private String strVideoPath = ""; 
private String TAG — "HIPPO VIDEOVIEW"; 
ImageView view; 

List<String> it=new ArrayList<String>(); 
ListView list; 

String ListString[]=new String[100]; 
public int flag=0,num; 

private String fName; 

private String end; 

private boolean isTrue; 

private TextView playlist, playmode; 
private int length=0; 


定义 OnltemClickListener 事 件 处 理 : 


private OnItemClickListener listener=new OnItemClickListener () 


GOverride 
public void onItemClick(AdapterView«» arg0, View argl, intarg2, long arg3) 


{ 

// TODO Auto-generated method stub 

num=arg2; 

String choseValue =arg0.getItemAtPosition (arg2) .toString(); 
strVideoPath = "file:// /sdcard/"+choseValue; 

playVideo (strVideoPath) ; 

} 

+ 


定义 OnClickListener 播 放 列表 事件 处 理 : 


private OnClickListener playlist_listener=new OnClickListener () 
{ 

GOverride 

public void onClick(View v) ( 

// TODO Auto-generated method stu 

showDialog (1); 

l 

1; 


定义 播放 模式 选择 对 话 框 : 


public Dialog ButildDialog(Context context) 
{ 

AlertDialog.Builder builder=new 
AlertDialog.Builder (context) ; 

builder. setTitle (" 播 放 模式 ") 7 
builder.setPositiveButton ("4 H4", 

new DialogInterface.OnClickListener () 

{ 

GOverride 

public void onClick(DialogInterface dialog, int which) 
{ 

// TODO Auto-generated method stub 

flag=0; 

} 

DE 

builder.setNegativeButton ("循环 播放 "， 

new DialogInterface.OnClickListener () 

{ 

GOverride 

public void onClick(DialogInterface dialog, int which) ( 
// TODO Auto-generated method stub 

flag-1; 

} 

D; 

return builder.create(); 


} 


获取 SD 卡 中 内 容 : 


private void getSD() 

{ 

Log.i("getSD", "it is here"); 

String s; 

if (isTrue) 

{ 

File f=new File("/sdcard/") ; 

File[] files-f.listFiles(); 

for(int i-0;i«files.length;i--*) 

{ 

File file-files[i]; 

fName=file.getPath (); 

end=fName. substring (fName. last IndexOf (".") +1, fName. length () ) .toLowerCase () ; 
if (end.equals ("Зар") | |end.equals ("mp4") | |end.equals ("mp3") ) 


{ 
it.add(file.getPath()); 
s=fName. substring (8); 


ListString[length]=s; 
lengtht++; 

$ 

l 

} 

if (it.isEmpty () ) 
setTitle("empty!!"); 
} 


程序 第 一 次 启动 时 ， 调 用 的 onCreate 方 法 : 


/** Called when the activity is first created. */ 
GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


定义 窗口 的 显示 样式 : 


getWindow().setFormat (PixelFormat . TRANSLUCENT) ; 
setContentView (В. layout .media) ; 
setTitle ("DMATEK MEDIAPLAYER") ; 


判断 外 部 存储 设备 类 型 : 


if (android.os.Environment .getExternalStorageState () .equals (andro 
id.os.Environment.MEDIA MOUNTED) ) 

{ 

isTrue=true; 

} 

Else 


isTrue=false; 

mMakeTextToast 

( 

getResources () .getText (R.string.str_err_nosd) .toString(), 
true 

); 

} 


获取 资源 ID 实例 化 成 员 变 量 : 


mVideoView01 = (VideoView)findViewById(R.id.myVideoViewl); 
view- (ImageView) findViewById (R.id.media pic); 


view 的 显示 : 


view.setVisibility (ImageView.VISIBLE); 


mVideoView01 的 播放 预备 状态 事件 处 理 : 


mVideoView01.setOnPreparedListener (new OnPreparedListener () 
{ 

GOverride 

public void onPrepared(android.media.MediaPlayer mp) { 

// TODO Auto-generated method stub 

} 

D; 


mVideoView01 的 播放 完成 状态 事件 处 理 : 


mVideoView01.setOnCompletionListener (new OnCompletionListener () 
{ 

GOverride 

public void onCompletion (android.media.MediaPlayer mp) 

{ 

// TODO Auto-generated method stub 

if (android.os.Environment .getExternalStorageState (). 

equals (android.os.Environment.MEDIA MOUNTED) ) 

{ 


if (flag==1) 

{ 

numt++; 

if (num>=length) 
num=0; 


String choseValueAgain 

=list.getItemAtPosition (num) .toString(); 
strVideoPath = "file:// /sdcard/"+choseValueAgain; 
} 

else 

mMakeTextToast 

( 

getResources () .getText (R.string.str_complete) .toString()+ 
"将 重复 播放 此 首 歌 曲 "， 

true 

); 

playVideo (strVideoPath) ; 

} 


l 
n; 


调用 getSD 方 法 : 


getSD(); 
Log.i("getSD", "getSD is good"); 


获取 资源 ID 实例 化 成 员 变 量 : 


playlist=(TextView) findViewById(R.id.media_PlayList) ; 
playmode- (TextView)findViewById (R.id.play mode); 
list- (ListView)findViewById(R.id.media list); 


添加 SD 卡 文件 字符 串 到 列表 字符 串 : 


ti 


String allString[]=new String[length]; 
Log.i("all String", "it is here"); 


for(int j=0;j<length; j++) 
allString[j]=ListString[j]; 
Log.i("all String ", "it is over"); 


绑 定 适配器 : 


list.setAdapter (new ArrayAdapter<String> (this, 
android.R.layout.simple list item l,allString)); 


设置 播放 列表 与 播放 模式 的 事件 监听 : 


Log.i("setAdapter", "it is here"); 
list.setOnItemClickListener (listener) ; 
Log.i("itemclick", "it is here"); 
playmode.setOnClickListener (playlist listener); 
} 


实现 onCreateDialog 方 法 : 


@Override 

protected Dialog onCreateDialog(int id) 
{ 

return ButildDialog (MediaPlayer.this) ; 
l 


播放 视频 方法 : 


private void playVideo (String strPath) 

{ 

String 

8-203str=strPath. substring (strPath.lastIndexOf (".")+1,strPath. length () ) 
. toLowerCase () ; 

if (str.equals ("mp3") ) 

{ 

view.setVisibility (ImageView. VISIBLE) ; 

] 

else 

{ 

view.setVisibility (ImageView. INVISIBLE) ; 


} 

if (strPath!="") 

{ 

mVideoView01.setVideoURI (Uri.parse (strPath) ); 
mVideoView01.setMediaController (new 
MediaController (MediaPlayer.this) ); 
mVideoView01.requestFocus () 7 
mVideoView01.start (); 

if (mVideoView01.isPlaying() ) 

{ 

Log.i(TAG, strPath); 

} 

} 

} 


Toast 提 示 方 法 : 


public void mMakeTextToast (String str, boolean isLong) 
{ 

if (isLong==true) 

{ 

Toast.makeText (MediaPlayer.this, str, 
Toast .LENGTH LONG) . show () ; 

} 

else 

{ 

Toast.makeText (MediaPlayer.this, str, 
Toast.LENGTH SHORT). show () ; 

} 

} 

} 


系统 函数 与 自 定义 函数 功能 说 明 : 
“ android.os.Environment.getExternalStorageState(): 系统 函数 ， 检 测 是 否 有 SD 卡 。 
SD0: 自 定义 函数 ， 读 取 SD 卡 根 目录 下 的 视频 和 音乐 文件 ， 在 本 程序 中 ， 只 读 取 mp4、mp3、3gp 格 式 文件 ， 将 读 取 到 的 文件 名 称 存 入 字符 事 ListSting 中 。 


+ ListView.setAdapter(): 此 函数 实现 的 功能 是 将 一 组 数据 在 ListView 中 显示 。 


+ ListView.setOnItemClickListener0 : 对 ListView 设 置 监听 事件 ， 当 点 击 ListView 中 的 选项 时 触发 此 事件 。 


+ VideoView.start(): 此 函数 可 以 实现 音乐 和 视频 文件 的 播放 。 


* VideoView.setOnCompletionListener(): 当 VideoView 中 的 音乐 、 视 频 文 件 播放 完毕 后 自动 触发 此 事件 。 


T 


: PlayVideo0: 自 定义 函数 ， 在 此 函数 中 ， 调 用 VideoView.start0 函 数 来 实现 视频 、 音 乐 文件 的 播放 。 


: ButildDialog0: 创建 一 个 对 话 框 ， 此 对 话 框 用 于 选择 播放 模式 。 


在 上 述 代码 中 ， 首 先 调 用 android.os.Environment.getExternalStorageState() 函 数 ， 用 来 检测 是 否 有 SD 卡 设备 ， 当 无 SD 卡 设备 后 ，Toast 控 件 提示 用 户 插入 SD 卡 。 然 后 再 执行 一 个 自 定义 函数 
getSD()， 读 取 SD 卡 中 可 播放 的 音乐 和 视频 文件 ， 然 后 执行 SetAdapter0) 将 文件 在 ListView 中 显示 。 当 点 击 ListView 中 所 显示 的 播放 曲目 后 ,执行 playVideo0 来 播放 音乐 和 视频 文件 。 


到 此 完成 了 MediaPlayer 制 作 实 验 设计 。 


6.5.4 ”MediaPlayer 程 序 测试 


接 下 来 测试 Mediaplayer 程 序 ， 步 又 如 下 : 


1) 打开 DMA-210XP 平 台 的 电源 ， 启 动 系统 。 


2) 安装 好 应 用 程序 。 


3) 把 音乐 和 视频 拷贝 到 SD 卡 中 ， 如 图 6-56 所 示 。 


4) 启动 程序 ， 如 图 6-57 所 示 。 
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图 6-56 ”把 视频 和 音乐 拷贝 到 SD 卡 中 
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图 6-57 启动 播放 程序 


5) 选择 一 首 音乐 ， 如 图 6-58 所 示 。 听 一 听 实 验 平台 是 否 播放 音乐 。 


6) 选择 一 个 视频 文件 ， 如 图 6-59 所 示 。 看 一 看 实验 平台 是 否 播放 视频 。 
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图 6-58 ”选择 一 首 音乐 播放 


DMATEK MEDIAPLAYER 


E 
F Pe 


азна ae d — 


P | “= 
= є. | Ld a 
p” па e И ç Mie 


"Wa А tu "s i luchas E 四 


图 6-59 ”视频 文件 播放 画面 


6.6 ”Camera 拍 照 及 摄影 程序 


6.6.1 Camera 简 介 


1.Camera 结 构 


一 般 来 说 ，Camera 主 要 是 由 lens 和 sensor IC 两 部 分 组 成 ， 其 中 有 的 sensor 1C 集 成 了 DSP， 有 的 没有 集成 ， 但 也 需要 外 部 DSP 处 理 。 下 面 详细 介绍 camera 设 备 的 组 成 部 分 。 


1) lens (镜头 ) 。 一 般 camera 的 镜头 由 几 片 透镜 组 成 ， 分 为 塑胶 透镜 (Plastic) 和 玻璃 透镜 (Glass) ， 通 常 镜头 结构 有 : 1P、2P、1G1P、1G3P、2G2P、4G 等 。 


2) sensor (图 像 传感器 ) 。senor 是 一 种 半导体 芯片 ， 有 两 种 类 型 : CCD 和 CMOS。sensor 将 从 lens 上 传导 过 来 的 光线 转换 为 电信 号 ， 再 通过 内 部 的 AD 转换 为 数字 信和 号。 由 于 sensor 的 每 个 像素 只 能 
感应 R 光 、B 光 或 G 光 ， 因 此 每 个 像素 此 时 存储 的 是 单 色 的 ， 我 们 称 之 为 RAW DATA 数 据 。 要 想 将 每 个 像素 的 RAW DATA 数 据 还 原 成 三 基色 ， 就 需要 |SP 来 处 理 。 


3) ISP (图 像 信 号 处 理 ) 。 主 要 完成 数字 图 像 的 处 理工 作 ， 把 sensor 采 和 集 到 的 原始 数据 转换 为 显示 支持 的 格式 。 


4) CAMIF (camera 控 制 器 ) 。 芯 片上 的 camera 接 口 电路 ， 对 设备 进行 控制 ， 接 收 sensor 采 集 的 数据 交 给 CPU， 并 送 入 LCD 进 行 显示 。 


2. 工 作 原 理 


外 部 光线 穿 过 lens 后 ， 经 过 color filter 滤 波 后 照射 到 sensor 面 上 ，sensor 将 从 lens 上 传导 过 来 的 光线 转换 为 电信 号 ， 再 通过 内 部 的 AD 转换 为 数字 信号 。 如 果 sensor 没 有 集成 DSP， 则 通过 DVP 的 方式 传 
输 到 baseband， 此 时 的 数据 格式 是 RAW DATA。 如 果 集 成 了 DSP， 则 RAW DATA 数 据 经 过 AWB、color matrix, lens shading、gamma、sharpness、AE 和 de-noise 处 理 后 ， 输 出 YUV 或 者 RGB 格式 的 


最 后 会 由 CPU 送 到 framebuffer 中 进行 显示 ， 这 样 就 能 看 到 camera 拍 报到 的 景象 了 。 


6.6.2. Android 系统 的 Camera 


Camera 系 统 主要 是 通过 下 层 的 硬 设备 摄影 机 设备 ， 获 取 数 据 交 给 Camera 系 统 作为 输入 设备 ， 摄 影 机 设备 通常 包含 数据 信号 处 理 控制 器 和 摄影 机 传感器 ， 摄 影 机 传感器 有 普通 的 和 智能 的 两 种 类 型 ， 摄 
影 机 的 主要 功能 是 给 系统 软件 提供 数据 。Android 下 的 Camera 系 统 的 基本 层次 结构 如 图 6-60 所 示 。 


应 用 程序 


Android 系 统 


Camera JNI, CameraService, Camera 
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Camera 设 备 


图 6-60 Android Camera 框 架 图 


从 图 6-60 可 知 ，Camera 系 统 和 其 他 系统 有 区 别 ，Camera 系 统 的 数据 并 不 一 定 都 传 给 了 上 层 应 用 程序 ， 有 些 可 以 被 系统 Framework 层 中 的 程序 直接 调用 ， 如 视讯 电话 功能 。 由 于 Camera 是 一 个 视讯 输 
入 设备 ， 所 以 与 视讯 有 关 的 系统 都 可 以 使 用 它 。 


从 Android 系 统 的 原始 程序 代码 进行 分 析 : 


1) 应 用 程序 ，Android 系 统 中 的 应 用 程序 。 


程序 代码 路 径 为 packages/apps/Camera/ 下 的 文件 。 


这 部 分 主要 是 为 Android 系 统 中 添加 Camera 应 用 程序 ，Camera.java 是 主要 实现 的 文件 。 


2) Camera 系 统 中 的 Java 程 序 代码 。 


程序 代码 路 径 为 : framework/base/core/java/android/hardware/Camera.java。 


这 个 类 和 jni 中 定义 的 类 是 一 个 类 ， 有 些 方法 通过 jni 的 方式 调用 本 地 程序 代码 得 到 ， 有 些 方法 自己 实现 ， 主 要 是 和 上 层 UI 有 关 。 


3) Camera 系 统 中 的 jni 程 序 代码 。 


程序 代码 路 径 为 : framework/base/core/jni/android hardware Camera.cpp. 


主要 是 提供 本 地 方法 ， 进 入 Java 与 C 的 数据 交互 。 该 代码 被 编译 成 库 libandroid_runtime.so， 被 放置 在 目标 系统 的 /system/lib 目 录 中 。 


4) Camera 系 统 中 的 本 地 库 。 
程序 代码 档案 路 径 为 : framework/base/include/camera/, 


程序 代码 源 文件 路 径 为 : framework/base/libs/camera/， 被 编译 成 库 libcamera_client.so。 


其 中 frameworks/base/libs/camera/ 中 的 Camera.cpp 文 件 用 于 实现 Camera.h 提 供 的 界面 。 


ul 


Camera 系 统 中 的 服务 部 分 。 


程序 代码 路 径 为 : framework/base/services/camera/libcameraservice/。 


它 可 以 直接 调用 Camera 硬 件 抽象 层 来 实现 ， 被 编译 成 库 libcameraservice.so。 
6) Camera 系 统 中 的 硬件 抽象 部 分 。 


Framework/base/include/camera/ (这 是 系统 的 路 径 ， 其 他 系统 可 能 在 Framework/base/include/ui/) 主要 文件 是 CamearaHardwarelnterface.h。 


7) 摄影 机 的 驱动 。 


为 了 实现 一 个 具体 功能 的 Camera， 在 最 底层 还 需要 一 个 硬件 相关 的 Camera 库 (例如 调用 video for linux 驱 动 程序 和 Jpeg 编 码 程序 实现 ) 。 这 个 库 将 被 Camera 的 服务 库 libcameraservice.so 调 用 。 


DMA-210XP 实 验 平台 使 用 OV3640 芯 片 。 


6.6.3 ”Camera 拍照 程序 设计 


Android 提 供 Camera 系 统 ， 只 要 获取 到 这 层 系 统 的 服务 ， 使 用 相应 的 AP1， 就 可 以 实现 Camera 系 统 中 的 拍照 功能 。 下 面 设计 一 个 拍照 功能 的 应 用 程序 。 


在 Android 系 统 中 已 经 实现 了 Camera 的 架构 ， 现 在 通过 Android 提 供 的 APl 来 实现 拍照 功能 ， 设 计 步 又 如 下 。 


1. 新 建 工程 


1) 在 Eclipse 中 新 建 一 个 工程 ， 在 Package Explorer 的 空白 处 点 击 鼠 标 右键 ， 如 图 6-61 所 示 。 


2) 在 弹出 菜单 中 选择 “New”-> “Project”， 如 图 6-62 所 示 。 
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3) 344% "Android" -> "Android Project" ， 点 击 “Next” 按 钮 ， 弹 出 图 6-63 所 示 的 窗口 ， 在 相应 位 置 填 入 信息 。 


f— Wew Android Project 


New Android Project 


Creates a new Android Project resource. 


Project name: |CameraTest 

Contents 

@ Create new project in workspace 

O Create project from existing source 


Use default location 


O Create project from existing sample 


Samples: 


Build Target 


Target Name Vendor 


Android 2.1-upd... Android Open Source Project 
C] Google APIs Google Inc. 


Standard Android platform 2.1-updatel 


Properties 


Platform 


e. sup. 
2.17Up... 


NE. 


T 
T 


Application name: CameraTest 


Package name: dmatek. xch. camera 


Create Activity: ICameraTest 


Min SDK Version: 1 


86-63 ”新 建 工程 窗口 


4) 点 击 “Finish” 按 钮 完成 创建 。 


2. 编 辑 main.xml 文 件 


Xml 文件 程序 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 

xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:orientation-"vertical" 

android:layout width-"fill parent" 

android:layout height-"fill parent" 

> 

<SurfaceView 

android: layout_width="fill parent" 


android:layout height-"fill parent" 
android: id="@+id/surfaceView" 

/> 

</LinearLayout> 


xml 文 件 定义 了 一 个 控件 的 布局 ， 这 个 布局 里 只 有 一 个 控件 ， 用 于 获取 Camera 系 统 的 数据 。 


3. 编 写 CameraTest 类 


1) 导入 需要 的 类 : 


import java.io.File; 

import java.io.FileOutputStream; 

import java.io. IOException; 

import android.app.Activity; 

import android.content.Context; 

import android.graphics.Bitmap; 

import android.graphics.Bitmap.CompressFormat; 
import android.graphics.BitmapFactory; 

import android.graphics.PixelFormat; 

import android. hardware.Camera; 

import android.hardware.Camera.PictureCallback; 
import android.os.Bundle; 

import android.os.Environment; 

import android.util.Log; 

import android.view.Display; 

import android.view.KeyEvent; 

import android.view.SurfaceHolder; 

import android.view.SurfaceView; 

import android.view.Window; 

import android.view.WindowManager; 


2) 定义 控件 及 成 员 : 


private static final String TAG = "CameraTest"; 
private SurfaceView surfaceView; 

private Camera camera; 

private boolean preview; 


3) 全 屏幕 显示 并 且 高 亮 显示 : 


Window window = getWindow(); 

requestWindowFeature (Window. FEATURE NO TITLE) ;// 没有 标题 

window. setFlags (WindowManager.LayoutParams.FlAG FULLSCREEN, Windo 
wManager.LayoutParams.FlAG FULLSCREEN) ;// 设置 全 屏幕 

window. addFlags (WindowManager.LayoutParams.FlAG KEEP SCREEN ON) ;// 


3 
a 


4) 初始 化 控件 及 成 员 : 


surfaceView =(SurfaceView) this.findViewById (R.id.surfaceView); 


5) 设置 SurfaceView 的 属性 : 


surfaceView.getHolder () .setFixedSize (640, 480); // ik 234 

/* 下 面 设 置 Surface 不 维护 自己 的 缓冲 区 ， 而 是 等 待 屏 幕 的 泻 染 引 擎 将 内 容 推 送 到 用 户 面前 */ 
surfaceView.getHolder () .setType (SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS) ; 
surfaceView.getHolder () .addCallback (new SurfaceCallback());// 一 个 回调 界面 


6) 创建 一 个 内 部 类 实现 这 个 回调 接口 方法 : 


private final class SurfaceCallback implements 
SurfaceHolder.Callback{ 
@Override 
public void surfaceChanged(SurfaceHolder holder, int format, int width,int height) 
{ 
} 
@Override 
public void surfaceCreated (SurfaceHolder holder) 
{ 
try { 
camera = Camera.open () ; 
WindowManager wm = (WindowManager) 
getSystemService (Context .WINDOW_SERVICE) ; 
Display display = wm.getDefaultDisplay(); 
Camera.Parameters parameters = camera.getParameters () ; 
parameters. setPreviewSize (display.getWidth (),display.getHeight ()); 
// 设置 预览 照片 的 大 小 
parameters.setPreviewFrameRate(3); // 每 秒 3 Wi 
parameters.setPictureFormat (PixelFormat.JPEG) ;// 设置 照片 的 输出 格式 
parameters.set ("jpeg-quality", 85); // 照片 质量 
parameters.setPictureSize (display.getWidth(),display.getHeight ()); 
// 设置 照片 的 大 小 
camera.setParameters (parameters) ; 
camera.setPreviewDisplay (surfaceView.getHolder ()); 
// 通过 SurfaceView 显示 取景 画面 
camera.startPreview(); // 开始 预览 
preview = true; 
} catch (IOException e) 
{ 
Log.e(TAG, e.toString()); 
) 


} 

GOverride 

public void surfaceDestroyed (SurfaceHolder holder) 
{ 
} 


这 个 方法 获取 了 一 个 硬件 camera 对 象 ， 并 设置 了 一 些 拍照 属性 ， 此 时 可 以 预览 效果 了 ， 但 还 没 加 权限 。 


7) 添加 一 个 按键 拍照 的 方法 : 


public boolean onKeyDown(int keyCode, KeyEvent event) { 
if(camera!-null && event.getRepeatCount ()==0) { 
switch (keyCode) { 
case KeyEvent.KEYCODE MENU: 
camera.takePicture (null, null, newTakePictureCallback()); 
break; 
case KeyEvent.KEYCODE BACK: 
if(camera!-null)( 
if(preview) camera.stopPreview(); 


camera. release () ; 
l 
this.finish(); 
break; 
} 
} 
return true; 


} 


8) 添加 一 个 保存 SD 卡 的 接口 TakePictureCallback0 回 调 : 


private final class TakePictureCallback implements PictureCallback{ 
public void onPictureTaken(byte[] data, Camera camera) { 
try { 
Е Bitmap bitmap = BitmapFactory.decodeByteArray (data, 0,data.length) ; 

File file = new 

File (Environment .getExternalStorageDirectory(), 

System. currentTimeMillis()+".jpg"); 

FileOutputStream outStream = new 

FileOutputStream (file); 

bitmap.compress (CompressFormat.JPEG, 100, outStream) ; 

outStream.close(); 

camera.stopPreview(); 

} catch (Exception e) { 

Log.e(TAG, e.toString()); 


«uses-permission android:name="android.permission.CAMERA"/> 
«1-- 在 SDCard 中 创建 与 删除 文件 权限 --> 

<uses-permission 

android:name-"android.permission.MOUNT UNMOUNT FILESYSTEMS"/» 
«1-- f&SDCard 写 入 资料 权限 --> m T 
<uses-permission 

android:name-"android.permission.WRITE EXTERNAL STORAGE" /> 


到 此 完成 Camera 程 序 设计 。 


测试 编写 的 Camera 程 序 的 步骤 如 下 : 


Т) 安装 APK， 把 Camera 实 验 工程 目录 下 的 APK 复 制 到 SD 卡 中 。 


2) 点 击 安装 好 的 APK， 如 图 6-64 所 示 。 
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BatteryTest BluetoothTest CameraTest CanBusSystem Demo Ultrasonic Dev Tools 
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6-64 Android 主 功能 接口 


出 现 一 个 全 屏幕 的 Camera 预 览 ， 如 图 6-65 所 示 。 


中 | 


3) 点 击 实验 平台 的 “FUNCTION_KEY” 按钮 进行 拍照 ， 照 片 保存 在 SD 卡 中 ， 如 


6-66 所 示 。 


BJ6-65 ”全 屏幕 的 Camera 预 览 


图 6-66 
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第 8 章 ”GPS 与 Google Map 定 位 系统 


书 管理 系统 
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第 7 章 Androids 
目前 针对 Android 的 程序 开发 主要 采取 人 工 编程 的 开发 方式 ， 对 于 开发 人 员 来 说 ， 不 但 效率 低下 ， 而 且 调 试 起 来 极其 不 方便 ， 只 有 在 界面 设计 阶段 可 实现 可 视 化 程序 开发 ， 如 布 伦 丹 的 开源 项 目 
此 ， 开 发 一 款 稳定 、 高 效 的 Android 应 用 程序 自动 生成 开发 工具 (Android 界 面 与 IO 


的 事件 代码 。 


Android 界 | 
形 界面 的 可 视 化 开发 ， 并 不 能 产生 功能 代码 。 


门 只 提供 图 
设计 工具 ) 具有 积极 的 现实 意义 。Android 界 面 与 IO 设计 工具 是 指 可 通过 可 视 化 开发 程序 的 方式 生成 Android 应 用 程序 


DroidDraw 和 Eclipse 中 的 界面 辅助 工具 Android Editor， 它 1 


Android 界 面 与 IO 设计 工具 可 以 帮助 Android 初 学 者 、Java 基 础 差 但 从 事 Android 开 发 的 人 员 快速 地 熟悉 Android 开 发 的 流程 、Android 界 面 设计 ， 包 括 布局 、 组 件 的 使 用 。 
一 些 简单 Android 程 序 开发 。 


户 可 以 先 通过 该 软件 完成 


Android 界 面 与 IO 设计 工具 对 有 关 Android 与 底层 硬件 连接 的 设计 有 很 大 的 帮助 。 但 Android 应 用 程序 开发 人 员 需 要 具备 一 定 的 Java 语 言 、XML 语 言 编 程 能 力 ，Android 界 面 与 IO 设计 工具 可 以 帮助 没有 
编程 语言 基础 的 人 员 设计 软件 。 


第 7 章 ” Android 界面 与 IO 设计 工具 


7.1 _ Android 界 面 与 IO 设计 工具 介绍 


目前 针对 Android 的 程序 开发 主要 采取 人 工 编程 的 开发 方式 ， 对 于 开发 人 员 来 说 ， 不 但 效率 低下 ， 而 且 调试 起 来 极其 不 方便 ， 只 有 在 界面 设计 阶段 可 实现 可 视 化 程序 开发 ， 如 布 伦 丹 的 开源 项 
DroidDraw 和 Eclipse 中 的 界面 辅助 工具 Android Editor， 它 们 只 提供 图 形 界面 的 可 视 化 开发 ， 并 不 能 产生 功能 代码 。 因 此 ， 开 发 一 款 稳定 、 高 效 的 Android 应 用 程序 自动 生成 开发 工具 (Android 界 面 与 IO 
设计 工具 ) 具有 积极 的 现实 意义 。Android 界 面 与 IO 设计 工具 是 指 可 通过 可 视 化 开发 程序 的 方式 生成 Android 应 用 程序 的 事件 代码 。 


Android 界 面 与 IO 设计 工具 可 以 帮助 Android 初 学 者 、Java 基 础 差 但 从 事 Android 开 发 的 人 员 快速 地 熟悉 Android 开 发 的 流程 、Android 界 面 设计 ， 包 括 布局 、 组 件 的 使 用 。 
一 些 简 单 Android 程 序 开发 。 


户 可 以 先 通过 该 软件 完成 


Android 界 面 与 IO 设计 工具 对 有 关 Android 与 底层 硬件 连接 的 设计 有 很 大 的 帮助 。 但 Android 应 用 程序 开发 人 员 需 要 具备 一 定 的 Java 语 言 、XML 语 言 编 程 能 力 ，Android 界 面 与 1O 设 计 工具 可 以 帮助 没有 
编程 语言 基础 的 人 员 设计 软件 。 


7.2 Android 界 面 与 IO 设计 工具 结构 


组 件 上 添加 相 


Android 界 面 与 0 设计 工具 是 通过 拖 外 思想 进行 程序 设计 的 。Android 程 序 设计 无 需 开 发 人 员 手 动 书写 代码 ， 只 需 根据 所 要 设计 的 界面 以 及 要 完成 的 功能 ， 通 过 拖 外 进行 界面 设计 ， 在 : 
应 的 监听 事件 ， 从 而 完成 程序 的 设计 。 


开发 人 员 将 组 件 拖 电 到 设计 界面 ， 通 过 双击 指定 组 件 ， 并 调整 组 件 的 属性 ， 达 到 所 需 的 效果 。 重 复 执 行 这 样 的 过 程 ， 直 到 完成 所 有 组 件 的 添加 ，Android 界 面 与 IO 设计 工具 界面 如 图 7-1 所 示 。 
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图 7-1 Android 界 面 与 IO 设计 工具 界面 


然后 通过 编译 生成 .xml 格 式 的 界面 文件 ， 生 成 Java 代 码 ， 最 后 生成 Android 安 装 包 .apk， 该 安装 包 可 以 直接 安装 到 实验 开发 平台 上 ， 使 开发 人 员 看 到 自己 动手 实验 的 结果 。 


Android 谋 入 式 软件 不 仅 能 实现 Android 界 面 布 局 的 设计 ， 还 可 以 与 一 些 底层 设备 进行 交互 。Android 嵌 入 式 软件 总 体 功能 设计 如 图 7-2 所 示 。 


菜单 栏 模块 
组 件 详 细 信 息 显 示 模 块 


功能 选择 模块 
辅助 功能 模块 
程序 设计 区 域 模块 


图 7-2 总体 功能 设计 区 


“ 菜单 栏 模 块 : 主要 包括 文件 模块 、 编 辑 模块 、 界 面 设计 模块 、I\O 接 口 模块 、 数 据 库 模 块 、 编 译 和 工程 模块 。 


“ 组 件 详细 信息 显示 模块 : 主要 进行 记录 用 户 所 选择 的 组 件 是 什么 ， 以 及 组 件 之 间 的 关联 关系 是 什么 。 此 处 的 关联 关系 主要 是 指 按钮 类 组 件 与 I/O 接 口 、 编 辑 框 、 文 本 框 之 间 的 控制 关系 。 通 过 树 状 结 


构 进行 显示 。 
“ 功能 选择 模块 : 主要 包括 界面 设计 、INO 设 计 、 数 据 库 设 计 ， 用 以 满足 程序 设计 的 基本 组 件 所 需 
“ 辅助 功能 模块 : 主要 用 来 显示 程序 编译 的 结果 。 当 编译 成 功 时 ， 会 显示 相应 的 “编译 成 功 ” 字 样 ， 编 译 失 败 会 显示 “编译 失败 ”并 显示 程序 出 错 的 大 致 位 置 。 


+ 程序 设计 区 域 模块 : 主要 是 进行 相应 的 程序 设计 。 此 处 可 以 进行 界面 设计 ， 并 对 相应 的 组 件 进行 功能 的 设置 ， 此 处 需要 结合 功能 选择 模块 完成 相关 设计 。 


下 面 是 Android 界 面 与 10 设 计 工具 的 框架 ， 主 界面 如 图 7-3 所 示 。 


事件 处 理 界面 。 当 通过 右 击 对 组 件 实施 添加 监听 时 ， 弹 出 事件 处 理 界面 ， 其 中 提供 了 该 组 件 可 以 添加 哪些 方面 的 功能 。 事 件 处 理 界面 如 图 7-4 所 示 。 
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图 7-3 主 界 面 
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图 7-4 ”事件 处 理 界面 


数据 库 界 面 设计 。 该 软件 支持 数据 库 功 能 ， 可 以 通过 数据 库 界 面 设计 进行 数据 库 表 的 生成 ， 达 到 存储 数据 和 查询 数据 的 效果 。 数 据 库 界面 如 图 7-5 所 示 。 
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图 7-5 数据库 界面 


以 上 是 Android 界 面 与 IO 设计 工具 的 设计 框架 。 下 面 将 详细 介绍 该 软件 设计 的 过 程 。 


73 _ Android 界面 与 IO 设计 工具 界面 设计 


7.3.1 界面 设计 


窗口 界面 设计 实现 步骤 如 下 : 


EN 


创建 一 个 java 工 程 ， 名 称 为 DroidDraw。 


2) 在 目录 org\droiddraw 下 会 有 一 个 main 函 数 作为 入 口 函 数 ， 接 下 来 进行 实现 系统 界面 初始 化 ， 加 载 表 示 组 件 的 图 片 ， 为 菜单 栏 各 项 添加 监听 等 工作 。 相 关 的 代码 介绍 如 下 : 


“ 定义 窗口 和 加 载 窗口 变量 的 代码 如 下 。 其 中 DroidDrawPanel 类 是 自 定义 类 ， 存 放 在 目录 org\droiddraw\gui 中 ， 用 以 实现 系统 显示 内 容 的 加 载 。 


// JErame: 构 建 窗 体 
static JFrame jf; 
static DroidDrawPanel ddp; 


“ 进行 界面 变量 初始 化 操作 ， 控 制 窗口 大 小 。 代 码 如 下 : 


jf = new JFrame( "Android 界 面 与 IO 设计 工具 界面 " ); 
Dimension displaySize 
Dimension frameSize jf.getSize(); 
if (frameSize.width>displaySize.width) { 
frameSize.width = displaySize.width; 


} 
if (frameSize.height>displaySize.height) { 


frameSize.height = displaySize.height; 


} 


// 显示 android 的 标题 名 称 


Toolkit.getDefaultToolkit ().getScreenSize();// 获取 屏幕 大 小 


jf.setLocation ((displaySize.width-frameSize.width) /2-650, (displaySize.height-frameSize. height)/2-400); 
// windows 的 监听 器 


jf.addWindowListener( new WindowAdapter () 
public void windowClosing( WindowEvent e ) 
quit( false ); 
} 
)); 


{ 
{ 


// 关闭 整个 窗口 


“ 加 载 界面 内 容 操作 的 代码 如 下 : 


ddp = new DroidDrawPanel( screen, true); 


AndroidEditor. instance () .setScreenMode( prefs.getScreenMode () 


fd = new FileDialog( jf ); 
jfc = new JFileChooser(); 


ү 


7.3.2 ”界面 内 容 添加 


将 窗口 进行 分 块 显示 ， 分 为 组 件 信息 显示 


区 、 功 能 


区 


界面 程序 画布 。 这 部 分 功能 实现 代 和 


要 是 实现 各 个 部 分 界面 的 显示 ， 也 包含 部 分 功能 的 实现 。 该 部 分 界面 代码 如 下 : 


要 在 org\droiddrawNgui 目 录 中 的 DroidDrawPanel 文 件 中 实现 。 这 个 文件 主 


package org.droiddraw.gui; 
public class DroidDrawPanel extends JPanel { 


private static final long serialVersionUID = 11; 


Dimension d = new Dimension (1300, 700); 
// 类 型 为 JtabbedPane 的 变量 al1ltb 为 功能 区 部 分 
JTabbedPane alltb = new JTabbedPane(); 
// 变量 left 由 jt，jtp 两 部 分 要 直 组 成 
static JSplitPane left = null; 
// out 为 辅助 功能 器 部 分 
static JTabbedPane out = new JTabbedPane () ; 
// 变量 jsp11 由 left，ct1 两 部 分 水 平 组 成 
static JSplitPane jspll-null; 
// 变量 ct1 由 alltb，out 两 部 分 垂直 组 成 
static JSplitPane ctl = null; 
JTabbedPane jtb = new JTabbedPane(); 
TextArea text; 
JTextArea jtext; 
static JPanel jtp=new JPanel (); 
static JComboBox jtlist=new JComboBox () ; 
详细 信息 显示 部 分 窗 体 
static JPanel jt = new JPanel(); 
static JSplitPane jsp=new JSplitPane(); 
static 
JPanel 
JPanel 
JPanel 
static 
static 


// 


databasejp ; 

databasejpup ; 
databasejpdown ; 
DefaultTableModel dtm; 
JTable table; 

static DefaultTableModel dtminfo; 
static JTable tableinfjt; 
Container dbcup=new Container (); 
JTextField tableNameT; 

static JTree jtree= new JTree(); 
static JTextArea jta-new JTextArea (); 


private Set<String> IOset-new HashSet<String>(); 


@Override 
public Dimension getMinimumSize() { 
return d; 
} 
@Override 
public Dimension getPreferredSize() { 
return d; 
} 
public void editSelected() { 
jtb.setSelectedIndex (5) 


} 


protected static final void switchToLookAndFeel (String clazz) 


try { 
UIManager.setLookAndFeel (clazz) ; 
} catch (Exception ex) { 
AndroidEditor.instance() „error (ex); 
} 
} 


protected static final void setupRootLayout (Layout 1) 
1.setPosition (AndroidEditor.OFFSET_X+1.getPadding (Widget . LEFT) +1.getMargin (Widget . LEFT) , AndroidEditor.OFFSET_Y+1.getPadding (Widget .TOP) +1.getMargin (Widget .TOP)); 
1.setPropertyByAttName ("android:layout_width", "fill parent"); Е 
l.setPropertyByAttName ("android:layout height", "fill parent"); 


l.apply(); 


public DroidDrawPanel (String screen, boolean applet) { 
switchToLookAndFeel (UIManager.getSystemLookAndFeelClassName () ) ; 


AndroidEditor ae 

if (applet) { 
text = new TextArea (10,50); 

} 

else { 
jtext 


new JTextArea (10,50); 


AndroidEditor.instance(); 


{ 


{ 


Hashtable<String, String > jtreeTable=new Hashtable<String, String>() ; 


jtext.getDocument ().addUndoableEditListener (new UndoableEditListener() { 
public void undoableEditHappened (UndoableEditEvent e) 
AndroidEditor.instance () .queueUndoRecord (e.getEdit ()) ; 


} 
n; 


AbsoluteLayout al = new AbsoluteLayout (); 


setupRootLayout (al); 
ae.setLayout (al); 

Image img - null; 

if ("qvgap".equals (screen)) { 


ae.setScreenMode (AndroidEditor.ScreenMode.QVGA PORTRAIT); 


img = ImageResources.instance|() . getImage ("emu2"); 

} 

else if ("hvgal".equals(screen)) { 
ae .setScreenMode (AndroidEditor.ScreenMode.HVGA LANDSCAPE); 
img = ImageResources. instance () .getImage ("emu3") ; 

} 

else if ("hvgap".equals(screen)) { 
ae .setScreenMode (AndroidEditor.ScreenMode.HVGA PORTRAIT); 
img = ImageResources. instance () .getImage ("emu4") ; 

} 

else if ("qvgal".equals(screen)) { 
ae .setScreenMode (AndroidEditor.ScreenMode.QVGA LANDSCAPE); 
img = ImageResources. instance () .getImage ("emul") ; 

} 

else if ("wvgap".equals(screen)) { 
ae.setScreenMode (AndroidEditor.ScreenMode.WVGA PORTRAIT); 
img = ImageResources.instance () .getImage ("emu4"); 

} 

else if ("wvgal".equals(screen)) { 


ae.setScreenMode (AndroidEditor.ScreenMode.WVGA LANDSCAPE); 
img = ImageResources.instance ().getImage ("emul") ; 


else if ("wvgap".equals(screen)) { 
ae .setScreenMode (AndroidEditor.ScreenMode.HVGA PORTRAIT); 
img = ImageResources. instance () .getImage ("emu4") ; 

} 

else if ("wvgal".equals(screen)) { 
img = ImageResources. instance () .getImage ("emul") ; 


final Viewer viewer = new Viewer(ae, this, img); 
JPanel jp = new JPanel(); 
ae.setViewer (viewer) ; 
setLayout (new BorderLayout () ) ; 
JButton edit; 
edit = new JButton ("445") 7 
JButton delete = new JButton ("WF"); 
JToolBar tb = new JToolBar(); 
tb.addSeparator () ; 
tb.add(edit); 
tb.addSeparator () ; 
tb.add (delete); 
tb.addSeparator () ; 
tb.setFloatable (false); 
JPanel p = new JPanel(); 
SpringLayout sl - new SpringLayout(); 
p.setLayout (sl); 
JLabel lbl = new JLabel (" 根 布局 :") 7 
final JComboBox layout = new JComboBox(new String[] {AbsoluteLayout.TAG NAME CH, LinearLayout.TAG NAME CH, RelativeLayout.TAG NAME CH, ScrollView.TAG NAME CH, TableLayc 
if (!System.getProperty ("os.name") . toLowerCase () . contains ("mac os x")) 
layout.setLightWeightPopupEnabled (false); 
tb.add (layout) ; 
p.add (tb) ; 
p.setSize(500, 300);// 设置 布局 大 小 
p.validate(); 
jp.setLayout (new BorderLayout ()); 
JComboBox screen size = new JComboBox (new String[] ("320x240", "240x320", "480x320", "320x480", "800х480", "480x800"]); 
Screen size.setSelectedIndex (3); 
JPanel top - new JPanel(); 
FlowLayout fl = new FlowLayout (); 
fl.setAlignment (FlowLayout.LEFT); 
top.setLayout (new GridLayout (2,2)); 
top.add (101); 
top.add (layout); 
top.add(new JLabel (" 屏 幕 分 状 率 : 
top.add(screen_size); 
р = new JPanel (); 
p.setLayout (#1); 
p.add (top); 
jp.add(p, BorderLayout .NORTH) ; 
jp.add(viewer, BorderLayout.CENTER); 
jp.setBorder (BorderFactory.createTitledBorder ("a At") ) 7 
JTabbedPane tabs = new JTabbedPane(); 
tabs.addTab("Layout", jp); 
JPanel wpButton = new JPanel(); 
JPanel mpButton = new JPanel(); 
wpButton.setLayout (new GridLayout (2,3) ) 7 
Button b = new Button (Button. TAG NAME CH); 
((ColorProperty) b. getPropert yByAttName ("android:textColor") ) .setColorValue (Color.black) ; 
mpButton.add(new WidgetPanel (b) ) ; 
RadioButton rb = new RadioButton (RadioButton.TAG NAME CH); 
((ColorProperty) rb. getPropertyByAttName ("android:textColor") ) .setColorValue (Color.black) ; 
mpButton.add(new WidgetPanel (rb) ); 
wpButton.add (mpButton) ; 
mpButton = new JPanel (); 
CheckBox cb = new CheckBox(CheckBox.TAG NAME CH); 
((ColorProperty) cb.getPropertyByAttName ("android:textColor") ) .setColorValue (Color.black) ; 
mpButton.add(new WidgetPanel (cb) ) ; 
mpButton.add(new WidgetPanel (new RadioGroup())); 
wpButton.add (mpButton) ; 
JPanel wpText = new JPanel (); 
JPanel mpText- new JPanel (); 
wpText.setLayout (new GridLayout (2,3)); 
EditView ev = new EditView(EditView.TAG NAME CH); 
( (ColorProperty)ev.getPropertyByAttName ("android:textColor")).setColorValue (Color.black); 
mpText.add(new WidgetPanel (ev) ); 
TextView tv = new TextView(TextView.TAG NAME CH); 
((ColorProperty) tv.getPropertyByAttName ("android:textColor") ) .setColorValue (Color.black) ; 
mpText.add(new WidgetPanel (tv) ); 
wpText .add (mpText) ; 
JPanel wpTime = new JPanel (); 
JPanel mpTime- new JPanel (); 
wpTime.setLayout (new GridLayout (2,3) ) 7 
AnalogClock ac = new AnalogClock(); 
ac.setSize(50, 50); 
mpTime.add(new WidgetPanel (ac) ); 
DigitalClock dcb = new DigitalClock(); 
( (ColorProperty)dcb.getPropertyByAttName ("android:textColor") ) .setColorValue (Color.black) ; 
mpTime.add(new WidgetPanel (dcb) ) ; 
mpTime.add(new WidgetPanel (new TimePicker())); 
wpTime.add (mpTime) ; 
mpTime- new JPanel (); 
DatePicker dp = new DatePicker (); 
dp.setSize(140, 40); 
mpTime.add(new WidgetPanel (dp) ); 
wpTime.add (mpTime) ; 
JPanel wpSpecial = new JPanel (); 
JPanel mpSpecial= new JPanel (); 
wpSpecial.setLayout (new GridLayout (2, 3)); 
mpSpecial.add(new WidgetPanel (new ProgressBar () ) ) ; 
mpSpecial.add(new WidgetPanel (new TabWidget ())); 
wpSpecial.add (mpSpecial); 
JPanel pppButton - new JPanel(); 
pppButton.add (wpButton) ; 
JScrollPane jswpButton = new JScrollPane (pppButton); 
jswpButton.setMinimumSize (new Dimension (wpButton.getWidth(), 160)); 
JPanel pppSpecial - new JPanel(); 
pppSpecial.add(wpSpecial ); 
JScrollPane jswpSpecial = new JScrollPane (pppSpecial); 
jswpSpecial.setMinimumSize (new Dimension (wpSpecial.getWidth(),160)); 
JPanel pppTime - new JPanel(); 
pppTime.add (wpTime); 
JScrollPane jswpTime - new JScrollPane (pppTime); 
jswpTime.setMinimumSize (new Dimension (wpTime.getWidth(), 160)); 
JPanel pppText - new JPanel(); 
pppText . add (wpText) ; 
JScrollPane jswpText = new JScrollPane (pppText); 
jswpText.setMinimumSize (new Dimension (wpText.getWidth(),160)); 
JPanel wp = new JPanel(); 
JPanel mp = new JPanel(); 
wp.setLayout (new GridLayout (0,1) ) 7 
JPanel lp = new JPanel(); 
lp.setLayout (new GridLayout (0,1) ); 
mp = new JPanel (); 
mp.setLayout (new FlowLayout ()); 
mp.add(new WidgetPanel (new AbsoluteLayout () ) ) ; 
mp.add(new WidgetPanel (new FrameLayout ())) 
mp.add(new WidgetPanel (new LinearLayout () ) 
mp.add(new WidgetPanel (new ScrollView())); 


) 
T 


lp.add (mp); 
mp = new JPanel(); 
.add(new WidgetPanel (new RelativeLayout ())); 


mp 

TableRow tr = new TableRow(); 
tr.setSizeInternal(70, tr.getHeight ()); 
mp.add(new WidgetPanel (tr) ); 

mp.add(new WidgetPanel (new TableLayout ())); 
mp.add(new WidgetPanel (new Ticker ())); 
lp.add (mp); 

mp = new JPanel(); 

mp.add(1p); 

JScrollPane jslp - new JScrollPane (mp); 


jtb.addTab ("布局 "，jslp); 
jtb.addTab ("按钮 类 "，jswpButton); 
"文本 类 "，jswpText); 


jtb.addTab ("时 间 类 "，jswpTime); 
jtb.addTab ("特殊 类 "，jswpSpecial); 
jtb.addTab ("属性 "，AndroidEditor.instance() .getPropertiesPanel ()); 
if (!applet) { 
jtb.addTab ("#44 #", new StringsPanel()); 
jtb.addTab ("й ё", new ColorsPanel()); 
jtb.addTab ("数组 "，new ArrayPanel()); 


( 
( 
jtb.addTab( 
( 
( 


l 
jtb.setName ("界面 设计 "); 
// 数据 库 设计 界面 
databasejp = new JPanel (); 
databasejpup = new JPanel () ; 
databasejpdown = new JPanel (); 
JLabel tableNameL-new JLabel ("#4") ; 
tableNameT-new JTextField(); 
JButton dbtadd-new JButton ("#2047"); 
JButton dbtsub=new JButton (" 删 除 行 ") 7 
JButton dbcreat=new JButton (" 生 成 表 ") ; 
JButton dbnew-new JButton (" 增 加 表 ") 
ActionListener DBButtonlistener=new ActionListener () { 
@Override 
public void actionPerformed (ActionEvent e) { 
if (e.getActionCommand() .equals ("$40 4") ) { 
// 生成 表 
int m=dtm.getColumnCount () ; 
int n=dtm.getRowCount () ; 
System.out.println("n-"4n*" m="+m); 
String[][] data-new String[n] [m]; 
for(int i=0;i<n;it++) { 
for(int j20;j«m; j++) { 
data [1] [j]=(String) table.getValueAt (i,j); 
} 


} 
tableNameT-new JTextField(); 
databasejpup. add (dbcup) ; 
databasejpdown.removeAll(); 
databasejpdown.add (dbtablejsp, BorderLayout .CENTER) ; 
JSplitPane dbjs=new 
JSplitPane (JSplitPane.VERTICAL SPLIT,databasejpup, database jpdown) ; 
databasejp.add (dbjs) ; 
databasejp.validate(); 
} 

}; 

JPanel outIO = new JPanel (); 

outlIO.setLayout (new BorderLayout () ) ; 

outIO.add(text!=nulltext:new JScrollPane(jtext), BorderLayout.CENTER); 

outIO.setBorder (border); 

alltb.addTab ("界面 设计 ", jtb) ; 

alltb.addTab("IOitif",outIO); 

alltb.addTab ("数据 库 设 计 ", databasejp) ; 

Font font = new Font (null,Font.BOLD,14); 

jta.setFont (font); 

jta.setBackground (Color.BLACK) ; 

jta.setForeground (Color.WHITE) ; 

out.setBorder (BorderFactory.createTitledBorder (" 辅 助 功能 区 ") ) ; 

out.addTab ("编译 输出 ", ја); 

// 组 件 详细 信息 显示 区 加 载 

DefaultMutableTreeNode c=new 

DefaultMutableTreeNode( "DroidDrawActivity ", true); 

DefaultMutableTreeNode uiElement2-new DefaultMutableTreeNode ("组 件 信 息 提示 ",true); 

c.add (uiElement2) 7 

JTree tree = new JTree(c); 

jtp.setLayout (new BorderLayout () ) ; 

// 显示 已 建 数据 库 表 

jtp.add(new JLabel("android 程 序 中 已 建 表 列表 ") , BorderLayout .NORTH) ; 

jtlist.setPreferredSize (new Dimension(10,10)); 

jtp.add (jtlist,BorderLayout.CENTER); 

jtat.setLayout (new ScrollPaneLayout ()); 

jtp.setPreferredSize (new Dimension(1, 1)); 

jt.add(new JScrollPane (tree),BorderLayout.NORTH); 

jt.setPreferredSize (new Dimension (300, 400)); 

left = new JSplitPane(JSplitPane.VERTICAL SPLIT, jt, jtp); 
alltb.setPreferredSize (new Dimension(450, 400)); 
// 各 个 部 分 相对 位 置 关 系 的 确定 

ctl = new JSplitPane(JSplitPane.VERTICAL SPLIT, alltb, out); 

jspll- new JSplitPane (JSplitPane.HORIZONTAL SPLIT, left,ctl ); 

jsp = new JSplitPane (JSplitPane. HORIZONTAL SPLIT, jspll, јр); 

p = new JPanel (); 

FlowLayout £2 = new FlowLayout (); 

£2.setAlignment (FlowLayout .CENTER) ; 

p.setLayout (£2) ; 

p.add (tb) ; 

jp.add(p, BorderLayout .SOUTH) ; 

add(jsp, BorderLayout.CENTER); 


74 Android 界面 与 IO 设计 工具 功能 选择 区 设计 


Android 界 面 与 IO 设计 工具 功能 选择 区 设计 部 分 包括 界面 设计 、1O 设 计 和 数据 库 设计 ， 如 图 7-6 所 示 。 


[ 


数据 库 设 计 


图 7-6 ”功能 区 部 分 


功能 选择 区 


要 代码 叙述 如 下 : 


JTabbedPane alltb = new JTabbedPane () ; 
JTabbedPane jtb = new JTabbedPane(); 

JPanel databasejp ; 

JTabbedPane jtb = new JTabbedPane(); 

JPanel outIO = new JPanel (); 

jtb. setName (" 界 面 设计 ") ; 

alltb.addTab ("界面 设计 ",jtb); 

alltb.addTab ("IO 设 计 ", outIO) ; 

alltb.addTab ("数据 库 设计 ", databasejp) ; 
alltb.setPreferredSize (new Dimension(450, 400)); 
ctl = new JSplitPane (JSplitPane.VERTICAL SPLIT, alltb, out); 


这 部 分 代码 可 以 参看 1.3.2 节 中 的 内 容 。 


74.1 界面 设计 


功能 选择 区 的 界面 设计 分 为 六 个 模块 ， 分 别 为 布局 、 按 钮 类 、 文 本 类 、 时 间 类 、 特 殊 类 、 属 性 组 成 。 下 面 是 各 个 模块 界面 及 实现 代码 。 


1. 布 局 类 


布局 类 中 包括 绝对 布局 、 框 架 布 局 和 线性 布局 等 ， 如 图 7-7 所 示 。 


图 7-7 布局 类 


布局 类 功能 的 实现 过 程 如 下 。 


1) 在 org\droiddrawNgui 中 的 DroidDrawPanel 类 中 有 生成 “布局 ”的 显示 代码 ， 如 下 : 


JPanel lp = new JPanel(); 
lp.setLayout (new GridLayout (0,1) ) 7 
mp = new JPanel (); 
mp.setLayout (new FlowLayout () ) ; 
mp.add(new WidgetPanel (new AbsoluteLayout ())); 
mp.add (new WidgetPanel (new FrameLayout () ) ) 
mp.add(new WidgetPanel (new LinearLayout () ) 
mp (new ; 


) 
) 


.add(new WidgetPane1 (nt ScrollView())) 
lp.add (тр); 
mp = new JPanel (); 


mp.add(new WidgetPanel (new RelativeLayout ())); 
TableRow tr = new TableRow(); 
tr.setSizeInternal (70, tr.getHeight ()); 
mp.add(new WidgetPanel (tr) ); 

mp.add(new WidgetPanel (new TableLayout () ) ) ; 

mp 


.add (new WidgetPanel (new Ticker())); 
lp.add (тр); 
mp = new JPanel(); 
mp.add (lp); 


JScrollPane jslp = new JScrollPane (mp); 
jtb.addTab ("p E", jslp); 


2) 在 上 述 代码 中 方法 WidgetPanel 是 实现 布局 的 主要 方法 。 代 码 如 下 : 


public class WidgetPanel extends JPanel implements DragGestureListener, DragSourceListener { 
private static final long serialVersionUID = 1L; 
Widget w; 
Dimension d; 
DragSource ds; 
BufferedImage img; 
int x, y; 
public WidgetPanel(Widget w) ( 
this.w = w; 
d = new Dimension (w.getWidth(), w.getHeight ()); 
this.w.setPosition(0, 0); 
this.setToolTipText (w.getTagName () ) ; 
this.ds = DragSource.getDefaultDragSource () 7 
this.ds.createDefaultDragGestureRecognizer (this, DnDConstants.ACTION COPY, this); 
this.img = new BufferedImage (w.getWidth(), w.getHeight(), BufferedImage.TYPE 4BYTE ABGR); 
Graphics g - img.getGraphics(); 
w.paint (9); 
this.addMouseListener (new MouseListener() ( 
public void mouseClicked(MouseEvent e) ( 
if (e.getClickCount() » 1) ( 
AndroidEditor.instance().getLayout().addWidget (ViewerListener.createWidget (WidgetPanel.this.w.getTagName ())); 
AndroidEditor.instance().setChanged (true); 
) else ( 
if (WidgetPanel.this.w.getParent() != null) { 
AndroidEditor.instance().select (WidgetPanel.this.w); 
} 
} 
} 
public void mouseEntered(MouseEvent e) { } 
public void mouseExited(MouseEvent e) { } 
public void mousePressed(MouseEvent e) { } 
public void mouseReleased(MouseEvent e) { } 
DE 
} 


GOverride 
public Dimension getMinimumSize() ( return d; } 
GOverride 
public Dimension getPreferredSize() ( return d; ] 
GOverride 
public void paint (Graphics g) { 
w.paint (g) ; 


} 
public void dragGestureRecognized (DragGestureEvent e) { 
try { 
Transferable t = new StringSelection (w.getTagName () ) ; 
ds.startDrag(e, DragSource.DefaultCopyDrop, img, new Point(x,y), t, this); 
// ds.startDrag(e, DragSource.DefaultCopyDrop, t, this); 
} catch (InvalidDnDOperationException ex) { 
AndroidEditor.instance().error (ex); 


} 


public void dragDropEnd (DragSourceDropEvent e) {} 

public void dragEnter (DragSourceDragEvent e) {} 

public void dragExit (DragSourceEvent e) {} 

public void dragOver (DragSourceDragEvent e) {} 

public void dropActionChanged (DragSourceDragEvent arg0) {} 


2. 按 钮 类 


按钮 类 包括 普通 按钮 、 单 选 按钮 、 单 选 按钮 组 和 复 选 框 等 ， 如 图 7-8 所 示 。 


图 7-8 按钮 类 


按钮 类 功能 的 实现 过 程 如 下 : 


1) 在 org\droiddraw\gui 中 的 DroidDrawPane| 类 中 有 生成 “按钮 类 ”的 显示 代码 ， 如 下 : 


JPanel wpButton = new JPane1 () ; 
JPanel mpButton = new JPane1 () ; 
wpButton.setLayout (new GridLayout (2,3) ) 7 
Button b = new Button (Button. TAG NAME CH); 
( (ColorProperty) b.getPropertyByAttName ("android:textColor")).setColorValue (Color.black) ; 
mpButton.add(new WidgetPanel (b) ) ; 
RadioButton rb = new RadioButton (RadioButton.TAG NAME CH); 
( (ColorProperty) rb.getPropertyByAttName ("android:textColor")).setColorValue (Color.black) ; 
mpButton.add(new WidgetPanel (rb) ); 
wpButton.add (mpButton) ; 
mpButton = new JPanel(); 
CheckBox cb = new CheckBox(CheckBox.TAG NAME CH); 
((ColorProperty)cb.getPropertyByAttName ("android:textColor")).setColorValue (Color.black); 
mpButton.add(new WidgetPanel (cb) ); 
mpButton.add(new WidgetPanel (new RadioGroup())); 
wpButton.add (mpButton) ; 
JPanel pppButton = new JPanel(); 
pppButton.add (wpButton) ; 
JScrollPane jswpButton = new JScrollPane (pppButton); 
jswpButton.setMinimumSize (new Dimension (wpButton.getWidth(), 160)); 
jtb.addTab ("#42 Ж", jswpButton); 


2) 在 上 述 代码 中 可 以 看 到 Button 类 、RadioButton 类 、CheckBox 类 和 RadioGroup 类 ， 这 些 类 都 对 应 相关 组 件 显示 在 功能 区 中 。 接 下 来 以 Button 类 为 例 ， 进 行 说明， 代码 如 下 : 


public class Button extends TextView { 
public static final String TAG NAME = "Button"; 
public static final String TAG NAME CH = "按钮 "; 
NineWayImage img; Е Е 
Image img base; 
StringProperty onClick; 
public Button (String txt) { 
super (txt) ; 
this.setTagName (TAG_NAME) ; 
pad_x = 10; 
pad_y = 0; 
img_base = null; 
String theme = AndroidEditor.instance() .getTheme () ; 
if (theme == null || theme.equals("default")) { 
img base = ImageResources. instance () .get Image ("def/btn default normal.9"); 
if (img_base != null) { 
this.img = new NineWayImage (img base, 10, 10); 
} 


} 
else if (theme.equals("light")) { 
img base = ImageResources. instance () .getImage ("light/button_background_normal.9") ; 
if (img base != null) { 
this.img = new NineWayImage (img base, 10, 10); 
} 
} 
this.onClick = new StringProperty("Click Listener Classname", "droiddraw: onClickListener", null); 
addProperty (onClick); 
арр1у(); 


public void apply() { 
super.apply(); 
this.baseline = fontSize*2; 
] 
protected int getContentHeight() { 
if (img base != null) { 
return img base.getHeight (null) -4; 
} 
else { 
return 10; 
} 
} 
protected int getContentWidth() { 
int w = super.getContentWidth () ; 
if (img base != null && w < img base.getWidth(null)) { 
return img base.getWidth (null); 
} 
return w; 
} 
public void paint (Graphics g) { 


if (img = null) { 
g.setColor (Color.white) ; 
g.fillRoundRect (getX(), getY(), getWidth(), getHeight(), 8, 8); 
g.setColor (Color.black); 
g.drawRoundRect (getX(), getY(), getWidth(), getHeight(), 8, 8); 


else { 
img.paint(g, getX(), getY(), getWidth(), getHeight()); 
g.setColor (Color.black) ; 


g.setFont (f) ; 

g.setColor (textColor.getColorValue () ) ; 

drawText (g, 0, getHeight()/2+fontSize/2-5, CENTER); 
} 


3. 文 本 类 


文本 类 包括 编辑 框 和 文本 框 两 部 分 ， 如 图 7-9 所 示 。 


图 7-9 文本 类 


文本 类 功能 的 实现 过 程 如 下 : 


1) 在 org\droiddraw\gui 中 的 DroidDrawPanel 类 中 有 生成 “文本 类 ”的 显示 代码 ， 如 下 : 


JPanel wpText = new JPane1 () ; 
JPanel mpText- new JPanel () ; 
wpText.setLayout (new GridLayout (2,3) ) 7 
EditView ev = new EditView(EditView.TAG NAME CH); 
// 控制 功能 区 按钮 中 显示 的 "按钮 "两 字 的 颜色 ， 此 刻 是 黑色 
((ColorProperty)ev.getPropertyByAttName ("android:textColor")).set ColorValue (Color.black) ; 
mpText.add(new WidgetPanel (ev) ); 
TextView tv = new TextView(TextView.TAG NAME CH); ((ColorProperty) tv.getP-ropertyByAttName ("android:textColor")).set ColorValue(Color.black) ; 
mpText.add(new WidgetPanel (tv) ); 
wpText . add (mpText) ; 
JPanel pppText = new JPanel () ; 
pppText . add (wpText) 7 
JScrollPane jswpText = new JScrollPane (pppText) ; 
jswpText.setMinimumSize (new Dimension (wpText.getWidth(),160)); 
jtb.addTab(" X K£", jswpText); 


2) 文本 类 具体 实现 的 代码 可 以 参考 按钮 类 中 的 代码 。 此 处 只 说 明 getPropertyByAttName 方 法 ， 该 方法 是 控制 功能 区 按钮 中 显示 的 “按钮 ”两 字 的 颜色 ， 此 刻 是 黑色 。 具 体 涉及 的 代码 如 下 : 


获得 属性 名 称 代码 如 下 : 


public Property getPropertyByAttName (String attName) { 
for (Property prop : props) { 
if (prop.getAttributeName().equals(attName)) ( 
return prop; 
} 
} 


return null; 


获得 属性 名 称 字样 等 代码 如 下 : 


public void setColorValue (Color c) { 
this.c = c; 
super. setStringValue (makeColor (this.c) ); 


public static final String makeColor(java.awt.Color c) { 
if (c = null) 
return 
return "#"+hexString (c.getAlpha ())* 
hexString (c.getRed()) + 
hexString (c.getGreen ()) + 
hexString(c.getBlue()); 


; 


} 
JPanel pppTime = new JPanel (); 
pppTime.add (wpTime) ; 
JScrollPane jswpTime = new JScrollPane (pppTime) ; 
jswpTime.setMinimumSize (new Dimension (wpTime.getWidth(), 160)); 


jtb.addTab ("1 й) Ж", jswpTime); 


4 时间 类 


时 间 类 包括 日 历 、 时 间 等 项 ， 如 图 7-10 所 示 。 


7-10 ”时 间 类 


在 org\droiddraw\gui 中 的 DroidDrawPane| 类 中 有 生成 “时 间 类 ”的 显示 代码 ， 如 下 : 


Jpanel wpTime = new Jpanel(); 
Jpanel mpTime- new Jpanel(); 
wpTime.setLayout (new GridLayout (2,3)); 
AnalogClock ac = new AnalogClock(); 
ac.setSize(50, 50); 
mpTime.add(new WidgetPanel (ac) ); 
DigitalClock dcb = new DigitalClock(); 
( (ColorProperty) dcb.getPropertyByAttName ("android:textC-olor")).setColorValue (Color.black) ; 
mpTime.add(new WidgetPanel (dcb) ) ; 
mpTime.add(new WidgetPanel (new TimePicker())); 
wpTime.add (mpTime) ; 
mpTime- new Jpanel (); 
DatePicker dp = new DatePicker (); 
dp.setSize(140, 40); 
mpTime.add(new WidgetPanel (dp) ); 
wpTime.add (mpTime) ; 
JPanel pppSpecial = new JPanel(); 
pppSpecial.add(wpSpecial ); 
JScrollPane jswpSpecial = new JScrollPane (pppSpecial); 
jswpSpecial.setMinimumSize (new Dimension (wpSpecial.getWidth(),160)); 
jtb.addTab ("特殊 类 "，jswpSpecial); 


5. 特 殊 类 


特殊 类 包括 滚动 条 和 切换 卡 ， 如 


7-11 所 示 。 


0 


7-11 特殊 类 


在 org\droiddraw\gui 中 的 DroidDrawPane| 类 中 有 生成 “特殊 类 ”的 显示 代码 ， 如 下 : 


JPanel wpSpecial = new JPanel (); 
JPanel mpSpecial= new JPanel (); 
wpSpecial.setLayout (new GridLayout (2,3) ); 

mpSpecial.add(new WidgetPanel (new ProgressBar () ) ) ; 

mpSpecial.add(new WidgetPanel (new TabWidget ())); 
wpSpecial.add (mpSpecial); 
JPanel pppButton - new JPanel(); 
pppButton.add (wpButton) ; 
JScrollPane jswpButton = new JScrollPane (pppButton); 
jswpButton.setMinimumSize (new Dimension (wpButton.getWidth(), 160)); 
JPanel pppSpecial - new JPanel(); 
pppSpecial.add(wpSpecial ); 
JScrollPane jswpSpecial = new JScrollPane (pppSpecial); 
jswpSpecial.setMinimumSize (new Dimension (wpSpecial.getWidth(),160)); 


.属性 


属性 是 指 各 个 组 件 的 属性 ， 此 处 可 以 设置 组 件 的 各 种 属性 。 如 图 7-12 所 示 为 Button 属 性 ， 可 以 根据 需要 进行 修改 。 


在 org\droiddrawNgui 中 的 DroidDrawPanel 类 中 有 生成 “属性 ”的 显示 代码 ， 下 面 这 行 代码 仅 是 将 属性 项 添加 到 界 


CES | RE [ SRR | WE | EE [RE 


Properties for: 


dbut tonas 


ap_content 


ap content 


图 7-12 ”属性 


jtb.addTab ("属性 "，AndroidEditor.instance() .getPropertiesPanel ()); 


下 面 是 属性 具体 实现 的 代码 ， 在 路 径 org\droiddrawNgui 下 的 PropertiesPanel 文 件 中 实现 了 属性 中 内 容 显示 和 相关 功能 ， 代 码 如 下 : 


package org.droiddraw.gui; 
public class PropertiesPanel extends JPanel implements ActionListener, PropertyChangeListener, KeyListener 
{ 
private static final long serialVersionUID = 1L; 
Vector<Property> properties; 
Hashtable<Property, JComponent> components; 
Hashtable<ColorProperty, Color> colorTable; 
Viewer viewer; 
Widget w; 
JPanel items; 
Dimension d; 
boolean applet; 
GridBagConstraints c = new GridBagConstraints (); 
GridBagLayout g=new GridBagLayout () ; 
String id = null; 
public PropertiesPanel (boolean applet) { 
this (new Vector<Property>(), null, applet); 


public PropertiesPanel (Vector<Property> properties, Widget w, boolean applet) { 
this.components = new Hashtable<Property, ЈСотропепі> (); 
this.colorTable = new Hashtable<ColorProperty, Color>(); 
this.w =w; 
this.applet = applet; 
setProperties (properties, w); 
this.d = new Dimension (200,400); 
} 
public void setApplet (boolean applet) { 
this.applet = applet; 
) 
public void setProperties (Vector<Property> properties, Widget w) { 
c.fill = GridBagConstraints.NONE; 
c.gridheight=1; 
c.gridwidth=1; 
c.anchor=GridBagConstraints.WEST; 
c.insets = new Insets (0,0,0,0); 
this.properties = properties; 
this. removeAl11 () ; 
this.w = w; 
if (w == null) 
return; 
w.setPropertyChangeListener (this) ; 
items = new JPanel (); 
items.setLayout (g) ; 
components.clear(); 
if (properties.size() > 0) { 
items.add(new JLabel ("Properties for: ")); 
items.add(new JLabel (w.getTagName ())); 
j 
java.awt.FlowLayout fl = new FlowLayout (1,0,0); 
fl.setAlignment (FlowLayout.LEFT); 


for (int t=0;t<properties.size();tt+) { 
Property prop=properties.get (t); 


JLabel label Line = new JLabel("-------------- "); 
items.add(label Line); 
int i=0; 


c.gridx-0; 
c.gridy-ttitl; 
g.setConstraints (label Line, c); 
if (prop.getEditable()) ( 
if (prop instanceof BooleanProperty) ( 
JPanel j=new JPanel(); 
c.gridx=0; 
c.gridy=t+1; 
g.setConstraints(j, с); 
items .add(j) 7 
JCheckBox jcb = new JCheckBox (prop.getEnglishName () ) ; 
jcb.setSelected ( ( (BooleanProperty) prop) .getBooleanValue () ); 
components.put (prop, jcb); 
c.gridx=1; 
c.gridy=t+1; 
g.setConstraints (jcb, c); 
items.add(jcb); 
Jelse if (prop instanceof IntProperty) { 
JLabel jl-new JLabel (prop.getEnglishName () ) ; 
c.gridx=0; 
c.gridy=t+1; 
g.setConstraints (jl, c); 
items.add(jl); 
JTextField jf = new JTextField (prop.getValue () !=nullprop.getValue().toString():"", 5); 
JPanel jp = new JPanel(); 
jp.setLayout (#1); 
јр.ааа (jf); 
components.put(prop, jf); 
c.gridx=1; 
c.gridy-ttl; 
g.setConstraints (jf, c); 
items.add(jp); 
је1ѕе if (prop instanceof ImageProperty) { 
JLabel jl-new JLabel (prop.getEnglishName () ) ; 
c.gridx=0; 
c.gridy=t+1; 
g.setConstraints (jl, c); 
items.add(jl); 
final JTextField jf = new JTextField (prop.getValue () !-nullprop.getValue ().toString():"", 10); 
JPanel jp = new JPanel(); 
jp.setLayout (£1); 
јр.ааа (jf); 
if (!applet) { 
JButton jb = new JButton ("ii"); 
// JButton jb = new JButton ("Browse"); 
jb.addActionListener (new ActionListener() { 
public void actionPerformed(ActionEvent e) { 
if (AndroidEditor.instance().getDrawableDirectory() == null) { 
JOptionPane.showMessageDialog (PropertiesPanel.this, "你 必须 选择 一 个 Drawable 路 径 。\n 如 果 你 选择 的 图 片 不 在 这 个 路 径 中 ，Nn 系统 将 复制 它 。"， "选择 Drawable 路 径 。"， 
File dir = Main.doOpenDir(); 
if (dir != null) { 
AndroidEditor.instance() .setDrawableDirectory (dir); 
) 


} 
File dir = AndroidEditor.instance () .getDrawableDirectory () 7 
if (dir != null) { 
File img = Main.doOpenImage (dir) ; 
if (img != null) { 
if (!img.getParentFile().equals(dir)) { 
try { 
FileCopier.copy(img, dir, true); 


1 
catch (IOException ex) { 
AndroidEditor.instance() „error (ех); 
} 
} 
String name = img.getName (); 
int ix = name.indexOf("."); 
if (ix != -1) { 
name = name.substring (0, ix); 
} 
jf.setText ("@drawable/"+name) ; 
jf.requestFocus(); 


} 


} 
n; 
jp.add (jb) ; 
} 
components.put (prop, jf); 
c.gridx=1; 
c.gridy=t+1; 
g.setConstraints (jp, c); 
items.add(jp); 
Jelse if (prop instanceof StringProperty) ( 
JLabel jl-new JLabel (prop.getEnglishName () ) ; 
c.gridx=0; 
c.gridy-ttl; 
g.setConstraints (jl, c); 
items.add(jl); 
JComponent jc; 
if (prop instanceof SelectProperty) ( 
JComboBox jcb = new JComboBox ( ( (SelectProperty) prop) .getOptions ()); 
jcb.setSelectedIndex ( ( (SelectProperty) prop) .getSelectedIndex () ) ; 
јс = jcb; 
} 
else if (prop instanceof ColorProperty) { 
јс = new ColorPanel ( ( (ColorProperty) prop) .getColorValue ()); 
) 
else ( 
if (prop.getAttributeName () .equals("android:layout_width") || 
prop.getAttributeName () .equals ("android: layout_height") ) 
{ 
Vector«String» v = new Vector<String>(); 
v.add(""); 
v.add("fill parent"); 
v.add("wrap content"); 
JAutoTextField jat = new JAutoTextField(v); 
jat.setStrict (false); 
jat.setColumns (10); 
if (prop.getValue() != null) { 
jat.setText (prop.getValue().toString()); 
) 
jc = jat; 
} 
е1зе { 
jc = new JTextField (prop.getValue () !=nullprop.getValue () . 
toString():"", 10); 
} 
} 
final Property рр = prop; 
prop.addPropertyChangeListener (new PropertyChangeListener() { 
public void propertyChange (PropertyChangeEvent evt) { 
Property p = (Property) evt.getSource () 7 
if (pp.getEnglishName () .equals ("Id") ) { 
id = evt.getNewValue() .toString(); 
} 
if (pp.getEnglishName () .equals ("XA") ) { 
System. out .println ("PropertiesPanel Pevt.getNewValue() .toString() 4 id 为 "tevt.getNewValue() .toString()+ id.substring(5) ); 
EventFrame. instance () .getKjtext () .put (id. substring (5) ,evt.getNewValue() .toString()); 
} 
JComponent jc = components.get (p); 
if (p instanceof BooleanProperty) ( 
( (JCheckBox) jc) . setSelected(( (Boolean)evt.getNewValue ()) .booleanValue()); 


} 
else if (p instanceof ColorProperty) { 

// TODO 
) 
else if (p instanceof SelectProperty) ( 

// TODO 
) 
else if (p instanceof StringProperty) ( 

if (jc != null)( 

( (JTextField) јс) .setText (evt.getNewValue ().toString()); 


} 


} 
E 
components.put(prop, jc); 
JPanel p = new JPanel(); 
p.setLayout (#1); 
p.add(jc); 
c.gridx=1; 
c.gridy=t+1; 
g.setConstraints (p, c); 
items.add(p); 


) 
} 
this.setLayout (new BorderLayout ()); 
this.add(new JScrollPane (items), BorderLayout.CENTER) ; 
if (properties.size() » O) ( 
JButton apply = new JButton("g JH"); 
apply.addActionListener (this); 
JPanel p = new JPanel(); 
p.add(apply); 
this.add(p, BorderLayout.SOUTH); 
} 
this.repaint (); 
this. invalidate (); 
} 
public void setViewer (Viewer v) { 
this.viewer = v; 
} 
public void actionPerformed(ActionEvent arg0) { 


apply () ; 


} 
// 当 设 置 完 属性 后 需要 进行 确认 ， 下 面 是 确认 时 需要 调用 的 方法 
protected void apply() { 
for (Property prop : properties) { 
if (prop.getEditable()) { 
if (prop instanceof BooleanProperty) { 
JCheckBox jcb = (JCheckBox) components.get (prop); 
((BooleanProperty) prop) .setBooleanValue (jcb.isSelected()); 
} 
else if (prop instanceof IntProperty) { 
JTextField jf = (JTextField) components .get (prop) ; 
try { 
( (IntProperty) prop) .setIntValue (Integer.parseInt (jf.getText ())); 
} catch (NumberFormatException ex) { 
AndroidEditor. instance () .error (ex); 


) 


} 
else if (prop instanceof StringProperty) { 
if (prop instanceof SelectProperty) { 
JComboBox jcb = (JComboBox) components. get (prop); 
if (jcb == null) { 
AndroidEditor. instance () .error ("无 法 找到 选择 :"+prop. 
getAttributeName () ) ; 
} 
else 
((SelectProperty) prop) .setSelectedIndex (jcb.getSelectedIndex () ) ; 
} 
else if (prop instanceof ColorProperty) { 
ColorPanel ср = (ColorPanel) components.get (prop); 
// ((ColorProperty) prop) .setColorValue (cp.getColor()); 
((ColorProperty) prop) .setStringValue (cp.getString()); 
} 
else { 
JTextField jtf = (JTextField) components.get (prop) ; 
if (jtf == null) 
AndroidEditor.instance().error("JUik A JL X Ж: "+prop. 
getAttributeName () ) ; 
else if (prop.getAttributeName () .equals("android:layout_width") | | 
prop.getAttributeName () .equals ("android: layout height") ) { 
if (!jtf.getText () .endsWith ("рх") && !jtf.getText () .equals ("wrap_content") && !jtf.getText () .equals ("fill_parent")){ 


AndroidEditor.instance () .error (" 语 法 错误 :" + prop.getEnglishName() + "\n\"px\" 是 一 个 宽 或 高 的 标记 ") ; 
((StringProperty)prop).setStringValue(jtf.getText() + "px"); 


} 
else 
( (StringProperty) prop) .setStringValue (jtf.getText ()); 
š 
else 
((StringProperty) prop) .setStringValue (jtf.getText ()); 


} 
} 
w.apply()7 
if (w instanceof Layout) { 
( (Layout) м) .repositionAllWidgets () 7 


м.арр1у(); 
} 
if (w.getParent() != null) 
w.getParent () .positionWidget (и); 
if (viewer != null) 


viewer.repaint (); 
) 
@SuppressWarnings ("unchecked") 
public void propertyChange (PropertyChangeEvent evt) ( 
if (w.equals(evt.getSource())) { 
setProperties ( (Vector<Property>)evt.getNewValue () w); 
š 
} 
public void keyPressed(KeyEvent e) {} 
public void keyReleased(KeyEvent e) () 
public void keyTyped(KeyEvent e) { 
if (e.getKeyCode() — KeyEvent.VK ENTER) ( 
applyO; 
} 


742 IO 设计 


在 Android 应 用 程序 设计 过 程 中 ， 很 重要 的 一 部 分 是 终端 与 底层 硬件 设备 的 连接 ， 本 模块 介绍 的 内 容 就 是 实现 这 样 连接 的 。1O 设 计 包括 LED、 步 进 电机 、 直 流 电 机 、ADC、UART 和 USB 等 部 分 ， 如 医 


13 所 示 。 


I0 设 计 | EEG 


[ |р [1] 步 进 电机 L I 直流 电机 [ |anc 


图 7-13 IO 设计 组 成 部 分 


下 面 是 针对 设计 的 显示 和 功能 代码 ， 该 部 分 代码 在 org\droiddrawNgui 中 的 DroidDrawPanel 类 中 。 


JPanel outIO = new JPanel(); 
outIO.setLayout (new BorderLayout () ) ; 
outIO.add(text!=nulltext:new JScrollPane (jtext), BorderLayout.CENTER); 
// IO 设计 监听 设计 
ActionListener IOCheckBoxlistener-new ActionListener () { 
GOverride 
public void actionPerformed (ActionEvent e) { 
JCheckBox cb-(JCheckBox) e.getSource(); 
if(cb.isSelected())( 
IOset.add(cb.getText ()) ; 
jelse{ 
IOset . remove (cb.getText () ) ; 
} 
} 
1; 
ActionListener IOButtonlistener-new ActionListener () { 
GOverride 
public void actionPerformed(ActionEvent e) ( 
PackageElement pe; 
if(ProjectHandler.instance ().getFileHandler () . isEmpty ()) { 
pe=new PackageElement ("DroidDrawActivity") ; 
ProjectHandler. instance () .getFileHandler() .put (pe.getClassName(), pe); 
felse{ 
pe-ProjectHandler.instance().getFileHandler().get ("DroidDrawActivity") ; 
} 
ProjectHandler.instance().getFileHandler().get("DroidDrawActivity"). setIOset (IOset); 
} 
1; 
JPanel IOControll = new ЈРапе1 (); 
IOControll.setLayout (new GridLayout (1,4) ) 7 
JCheckBox cl=new JCheckBox ("LED"); 
JCheckBox c2=new JCheckBox ("JF i} HL") ; 
JCheckBox c3-new JCheckBox (" 直 流 电机 ") ; 
JCheckBox c4=new JCheckBox ("Арс"); 
( 
( 


JCheckBox c5-new JCheckBox ("UART") ; 
JCheckBox c6=new JCheckBox ("USB"); 
// 添加 监听 
cl.addActionListener 
c2.addActionListener 
c3.addActionListener 
c4.addActionListener 
c5.addActionListener 
c6.addActionListener 


IOCheckBoxlistener); 
IOCheckBoxlistener); 
IOCheckBoxlistener); 
IOCheckBoxlistener); 
IOCheckBoxlistener); 
IOCheckBoxlistener); 


// 布局 设计 

IOControll.add(cl,BorderLayout.CENTER); 
IOControll.add(c2,BorderLayout.CENTER); 
IOControll.add(c3,BorderLayout.CENTER); 
IOControll.add(c4, BorderLayout .CENTER) ; 
IOControll.add(c5, BorderLayout .CENTER) ; 
IOControll.add(c6,BorderLayout.CENTER); 
JPanel IOControl2 - new JPanel(); 
JButton IObutton-new JButton ("#4 Æ"); 


TObutton.setSize (30, 30); 
IObutton.addActionListener (IOButtonlistener); 
IOControl2.add (IObutton,BorderLayout.CENTER); 
outIO.add(IOControll, BorderLayout.CENTER); 
outlIO.add(IOControl2, BorderLayout.SOUTH); 
TitledBorder border = BorderFactory.createTitledBorder ("Іоф"); 
outIO.setBorder (border); 
// 添加 到 整体 系统 中 
alltb.addTab ("IO 设 计 ", outIO); 


7.4.3 ”数据 库 设 计 


Android 界 面 与 IO 设计 工具 数据 库 设计 包括 表 名 、 列 名 、 类 型 、 大 小 、 判 断 是 否 为 主键 等 功能 ， 如 图 7-14 所 示 。 图 7-15 所 示 为 对 已 经 生成 的 表 进 行 显示 。 


715 显示 已 生成 的 表 


1) 数据 库 设 计 部 分 的 显示 代码 在 org\droiddraw\gui 中 的 DroidDrawPanel 类 中 ， 如 下 : 


databasejp = new JPanel () ; 

databasejpup = new JPanel (); 
databasejpdown = new JPanel (); 

JLabel tableNamel-new JLabel ("#%"); 
tableNameT-new JTextField(); 

JButton dbtadd-new JButton (" 增 加 行 ") 7 
JButton dbtsub-new JButton (" 删 除 行 ") ; 
JButton dbcreat-new JButton ("Ж жж"); 


JButton dbnew-new JButton ("$404"); 
ActionListener DBButtonlistener=new ActionListener () { 
@Override 
public void actionPerformed (ActionEvent e) { 
if (e.getActionCommand () .equals (" 增 加 表 ") ) ( 
// 生成 表 
int m=dtm.getColumnCount (); 
int n=dtm.getRowCount () ; 
System.out.println("n-"4n*" m="+m); 
String[][] data=new String[n] [m]; 
for(int i=0;i<n;it++) { 
for (int j=0;j<m;j++) { 
data [1] [j]=(String) table.getValueAt (i,j); 
} 


} 

SQLiteDBHandler. instance () ; 
SQLiteDBHandler.getTable() .Put (tableNameT.getText(), data); 
changeHashDB () ; 

// 增加 表 后 将 表 名 置 空 

tableNameT-new JTextField(); 

// 生成 表 

String[][] info=new String[2] [4]; 

String |] names [PIAT "Жш", "k k" "TES RA"); 
dtm=new DefaultTableModel (info, names) ; 

table=new JTable (dtm) ; 

// 禁止 列 移动 

table.getTableHeader () .setReorderingAllowed (false) ; 
JComboBox dbtype-new JComboBox () ; 

dbtype.addItem ("ТЕХТ"); 

dbtype.addItem ("INTEGER"); 

dbtype.addItem ("REAL") ; 

JComboBox dbkey=new JComboBox () ; 
dbkey.addItem("Y"); 

dbkey.addItem("N"); 


table.getColumnModel () .getColumn (1) .setCellEditor (new DefaultCellEditor (dbtype)); 
table.getColumnModel () .getColumn (3) .setCellEditor (new DefaultCellEditor (dbkey) ) ; 


JScrollPane dbtablejsp-new JScrollPane (table); 
dbcup. remove (1) ; 

dbcup.add(tableNameT, 1); 

databasejpup.removeAll(); 

databasejpup. add (dbcup) ; 
databasejpdown.removeAll(); 

databasejpdown.add (dbtablejsp, BorderLayout .CENTER) ; 


JSplitPane dbjs-new JSplitPane (JSplitPane.VERTICAL SP-LIT,databasejpup, databasejpdown) ; 


databasejp.add (dbjs) ; 
databasejp.validate(); 
l 
if (e.getActionCommand () .equals (" 增 加 行 ") ) { 
dtm.addRow (new Vector ()) ; 
table. revalidate(); 
} 
if(e.getActionCommand() .equals ("删除 行 ")){ 
int rowcount=dtm.getRowCount ()-1; 
if (rowcount>=0) { 
dtm. removeRow (rowcount) ; 
dtm. setRowCount (rowcount) ; 
} 
table.revalidate(); 
} 
if (e.getActionCommand() .equals (" 生 成 表 ") ) { 
} 
} 
1; 
dbtadd. addActionListener (DBButtonlistener) ; 
dbtsub.addActionListener (DBButtonlistener) ; 
dbcreat.addActionListener (DBButtonlistener) ; 
dbnew.addActionListener (DBButtonlistener) ; 
dbcup.setLayout (new GridLayout (4,2)); 
dbcup.add (tableNameL); 
dbcup.add (tableNameT) ; 
dbcup. add (dbtadd) ; 
dbcup. add (dbtsub) ; 
dbcup.add (dbcreat) ; 
dbcup.add (dbnew) ; 
String[][] info-new String[2][4]; 
String[] names={" 列 名 "， "XA", "KA" "是 否 主键 "] 7 
dtm=new DefaultTableModel (info, names) ; 
table=new JTable (dtm); 
// 禁止 列 移动 
table.getTableHeader () .setReorderingAllowed (false) ; 
JComboBox dbtype-new JComboBox () ; 
dbtype.addItem ("ТЕХТ"); 
dbtype.addItem ("INTEGER"); 
dbtype.addItem ("REAL"); 
JComboBox dbkey=new JComboBox () ; 
dbkey.addItem("Y"); 
dbkey.addItem("N"); 
table.getColumnModel () .getColumn (1) .setCellEditor (new DefaultCellEditor (dbtype)); 
table.getColumnModel () .getColumn (3) .setCellEditor (new DefaultCellEditor (dbkey) ); 
JScrollPane dbtablejsp-new JScrollPane (table); 
databasejpup. add (dbcup) ; 
databasejpdown.add (dbtablejsp, BorderLayout .CENTER) ; 
JSplitPane dbjs=new JSplitPane (JSplitPane.VERTICAL SPLIT, databasejpup, dat-abasejpdown) ; 
databasejp.add (dbjs) ; B 


alltb.addTab ("数据 库 设 计 ", databasejp) ; 


SQLiteDBHandler.instance () .createDBFile 


2) 在 上 述 数 据 库 设 计 代码 中 涉及 一 个 SQLiteDBHandler 类 ， 用 以 实现 数 所 


居 库 的 基本 操作 ， 该 部 分 代码 在 org\droiddraw\androidcode 中 ， 如 下 : 


public class SQLiteDBHandler { 


private 
private 


String filePath="E:\\workspace\\activity\\"; 
String database="res\\raw\\database.txt"; 


static private HashMap<String, String[][]> table-new HashMap<String, String[][]>(); 


* SQLiteDatabase 使 用 分 六 种 
.打开 或 者 创建 数据 库 
.创建 表 


.删除 数据 


Private 
Private 
Private 
пи11)\";"; 
private 


+r 

* 2 

* 3. 插 入 数据 
* 4 k, 
+5 

* 6 


static final String CREATE_DATABASE="SQLiteDatabase.openOrCreateDatabase (" + "\"/data/data/org.droiddraw/databases/temp.db\", null) ;"; 


static final 
static final 
static final String DELETE SQL "delete from UserTable where id=1\";"; 

static final String QUERY="\"db.query (V'UserTableV",null,null,null,null,null, 


static final String CLOSE-"db.close();"; 


public void createDBFile() { 


String codeAll-""; 
if (!table.isEmpty ()) { 
Set<String> set=table.keySet (); 
for (String tablename : set) { 
codeAll-codeAll*createDBTable (tablename, table. get (tablename) ) +"/п"; 
} 
try { 
FileWriter fw- new FileWriter (filePath+database, true) ; 
PrintWriter pw=new PrintWriter (fw); 
pw.println(codeAll); 
if (pw!= null) 
pw.close(); 
if (fw != null) 
try { 
fw.close(); 
} catch (IOException e) ( 


\"create table UserTable( id integer primary key autoincrement, 
insert into UserTable (username, password) values ('атакег', '123') \";"; 


+ "username text,password text) \"; 


e.printStackTrace(); 


} 
} catch (IOException el) { 
el.printStackTrace(); 
} 
System.out.println (codeAll); 
} 


} 
public String createDBTable (String tablename,String[][] db) { 
String code-"create table "+tablename+" ("; 
int n-db.length; 
for(int i=0;i<n;i++) { 
for(int j-0;j 
if 


code-code-" "«db[i][j]; 


if (j==1) { 
code=code+" "+db[i] [j]; 

} 

if(j--3&&db[i] [j] .equals("Y")){ 

code=code+" primary key autoincrement,"; 

Jelse if (j==3&&db[i] [j] .equals ("М") &&i==n-1) { 
code=code+") ;"; 

Jelse if (j==3&&db[i] [j] .equals("N")) { 
code=code+", "7 


} 
} 

} 
return code; 

} 

public static String getCREATE TABLE SQL() { 
return CREATE TABLE SQL; 

} 

public static String getCREATE DATABASE() { 
return CREATE DATABASE; 

b 

public static String getINSERT SQL() { 
return INSERT SQL; 

} 

public static String getDELETE SQL() { 
return DELETE SQL; 

} 

public static String getQUERY() { 
return QUERY; 

} 

public static String getCLOSE() { 
return CLOSE; 

} 

private static SQLiteDBHandler inst; 


// 单 例 方法 
public static SQLiteDBHandler instance() { 
if (inst == null) 


inst = new SQLiteDBHandler () ; 
return inst; 


public static String createDataBase () { 
return getCREATE DATABASE () ; 


public static String createTable() { 
return "String creaTableStr =" +getCREATE_TABLE SQL () +"\п"+ 
"db.execSQL (creaTableStr);"; 


public static String insert () { 
return "String insertStr ="_+getINSERT_SQL()+"\n"+ 
"db.execSQL (insertStr);"; 


public static String delete() { 
return "String deleteStr ="_+getDELETE_SQL()+"\n"+ 
"db.execSQL (deleteStr);"; 


public static String query() { 
return "Cursor c="+getQUERY () ; 


public static String close() { 
return getCLOSE () ; 


public static HashMap<String, String[][]» getTable() { 
return table; 


public static void setTable(HashMap«String, String[][]» table) { 
SQLiteDBHandler.table = table; 


7.5 Android 界 面 与 IO 设计 工具 辅助 功能 区 设计 


[R] 


Android 界 面 与 IO 设计 工具 的 辅助 功能 区 是 在 菜单 栏 进行 编译 时 ， 用 来 显示 编译 结果 的 ， 此 部 分 只 是 做 了 简单 的 判断 。 辅 助 功 能 区 如 


7-16 所 示 。 


辅助 功能 


图 7-16 ”辅助 功能 区 
Т) 在 org\droiddraw\gui 中 的 DroidDrawPanel 类 中 有 相关 的 实现 代码 ， 如 下 : 


Font font = new Font (null,Font.BOLD,14); 
jta.setFont (font); 
jta.setBackground (Color.BLACK) ; 
jta.setForeground (Color.WHITE) ; 
out.setBorder (BorderFactory.createTitledBorder (" 辅 助 功能 区 ") ) ; 
out.addTab ("编译 输出 ", jta) ; 


2) 在 编译 生成 APK 时 需要 在 这 部 分 显示 生成 的 结果 是 否 正常 。 需 要 在 org\droiddraw\androidcode 目 录 下 实现 调用 功能 ， 下 面 所 示 为 截取 的 一 部 分 代码 。 


if(f2.exists()){// BERGHE 
String aCon=""; 
String line00- 


FileReader fw= new FileReader (f2); 
BufferedReader buff = new BufferedReader (fw) ; 
while( (line00 = buff.readLine()) != null) { 
аСоп=аСоп+1іпе00; 
} 
DroidDrawPanel.set ("a.txt 存 在 “编译 失败 "+aCon+"end") ; 
DroidDrawPanel . changeHash () ; 
Jelset 
String aCon-"" 
String line00-""; 
FileReader fw= new FileReader ("E:\\workspace\\activity\\b.txt") 7 
BufferedReader buff = new BufferedReader (fw); 
while ((1іпе00 = buff.readLine()) != null) { 
aCon=aCon+line00+"\n"; 


} 
DroidDrawPanel.set (aCont+"\n"+" 44 i$ KF \n"+"end") ; 


3) 在 上 述 代码 中 有 一 个 方法 changeHash， 该 方法 在 org\droiddrawNgui 中 的 DroidDraw-Panel 类 中 ， 是 与 组 件 显示 信息 部 分 相关 联 的 代码 。 具 体 如 下 : 


public static void changeHash () { 
jtree=JTreeView.newJtree () ; 
jt.removeAll(); 
jt.add (jtree, 0); 
jsp.validate(); 


7.6_Android 界 面 与 IO 设计 工具 程序 生成 区 设计 


[I 


本 节 介 绍 Android 界 面 与 IO 设计 工具 程序 生成 区 设计 ， 包 括 根 布局 、 屏 幕 分 辨 率 、 编 辑 和 删除 等 功能 ， 如 图 7-17 所 示 。 


BA: нта ` 
RADE: 320X480 


MG 上 午 9:22 
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图 7-17 程序 显示 区 


每 一 个 布局 都 有 自己 的 基础 布局 方式 ，Android 也 需要 设置 自己 的 根 布局 方式 ， 如 图 7-18 所 示 为 根 布局 的 选择 项 。 


2. 屏 幕 分 辩 率 


幕 分 辨 率 就 是 有 


率 越 高 ， 显 示 效 果 就 越 细腻 。 手 机 


下 面 就 针对 


屏幕 分 辩 率 进行 介绍 。 如 


7-19 所 示 为 Android 界 | 


幕 分 辨 率 规格 大 致 分 为 QVGA、HVGA、VGA、WVGA 四 种 ， 此 处 只 使 


Ë 


7-18 Жж 


幕 上 显示 的 像素 个 数 ， 分 辩 率 240x320 的 意思 是 水 平 像素 数 为 240 个 ， 垂 直 像素 数 为 320 个 。 分 辩 率 越 高 ， 像 素 的 数目 越 多 ， 感 应 到 的 


管理 器 中 所 设置 的 几 种 屏幕 分 辨 率 规格 。 


了 其 中 的 三 种 。 


图 


像 越 精密 。 而 在 


寸 一 样 的 情况 下 ,分 辨 


图 7-19 EDHE 


虽然 这 里 使 用 了 六 种 不 同 大 小 的 屏幕 分 辨 率 ， 但 其 实 它们 可 以 归结 为 QVGA、HVGA、WVGA 三 种 类 型 。 用 户 可 以 根据 需要 选择 适合 自己 的 分 辨 率 。 


- QVGA (Quarter VGA) , HA #240 X 320 320 X 2401 Æ o 


: HVGA (Half-size VGA) ， 其 分 辨 率 为 320X480 或 480X320 像 素 。 


- WVGA (Wide VGA) ， 其 分 状 率 为 480X800 或 800 X480 像 素 。 


3. 界 面 显示 


界面 显示 用 来 提供 给 用 户 进行 界面 设计 。 可 以 将 各 种 组 件 拖 钨 到 界面 显示 中 ， 设 计 出 用 户 喜 欢 的 界面 风格 。 如 图 7-20 所 示 ， 展 示 了 一 个 界面 设计 的 效果 图 。 


DreidDraw 


ret 


inte 


图 7-20 ”界面 显示 效果 图 


1) 在 org\droiddraw\gui 中 的 DroidDrawPanel 类 中 有 与 该 部 分 相关 联 的 代码 ， 如 下 : 


// 编辑 按钮 实现 
edit = new JButton (" 编 辑 ") ; 
edit.addActionListener (new ActionListener() { 
public void actionPerformed (ActionEvent e) { 
editSelected(); 
} 


n; 
// 删除 按钮 实现 
JButton delete = new JButton ("Fk"); 
delete.addActionListener (new ActionListener() { 
public void actionPerformed (ActionEvent arg0) { 
Widget w=AndroidEditor. instance () .getSelected(); 
AndroidEditor. instance () .removeWidget (м) ; 
HashMap<String, HashMap<String, UIElement>> ui=ProjectHandler. instance () . 
getFileHandler () .get ("DroidDrawActivity") .getUi () 7 
if(w instanceof Button) { 
HashMap<String, UIElement> u= ui.get ("Button"); 
String ids- w.getId() .substring(5); 
ProjectHandler.instance().getFileHandler() .get ("DroidDrawActivity") .getUi () .get ("Button") . remove (ids); 
u. remove (ids); 
JTreeView. instance () .getU () . remove (ids); 
} 
viewer. repaint (); 
} 
n; 
JToolBar tb = new JToolBar(); 
tb.addSeparator (); 
tb.add (edit); 
tb.addSeparator () ; 
tb.add (delete); 
tb.addSeparator () ; 
tb.setFloatable (false); 
JPanel p = new JPanel(); 
SpringLayout sl - new SpringLayout(); 
p.setLayout (sl); 
// 根 布局 实现 
JLabel lbl = new JLabel (" 根 布局 :") 7 
final JComboBox layout = new JComboBox(new String[] {AbsoluteLayout.TAG NAME CH, LinearLayout.TAG NAME CH, RelativeLayout.TAG NAME CH, ScrollView.TAG NAME CH, TableLayout 
if (!System.getProperty ("os.name").toLowerCase().contains("mac os x")) `” Е E Е Е 7 E 
layout.setLightWeightPopupEnabled (false); 
final ActionListener layoutActionListener - new ActionListener() ( 
public void actionPerformed(ActionEvent e) ( 
if (e.getActionCommand() .equals ("comboBoxChanged")) { 
String select = (String) ((JComboBox) e.getSource () ) 
Layout 1 = null; 
if (select.equals (AbsoluteLayout.TAG NAME CH)) { 
1 = new AbsoluteLayout () ; 


-getSelectedItem(); 


} 

else if (select.equals (LinearLayout.TAG NAME CH)) { 
1 = new LinearLayout (); 

} 

else if (select.equals (RelativeLayout.TAG NAME CH)) { 
l = new Relativelayout(); 

) 

else if (select.equals (ScrollView.TAG NAME CH)) { 
1 = new ScrollView(); 

) 

else if (select.equals (TableLayout.TAG NAME CH)) { 
1 = new TableLayout(); 

) 

else if (select.equals (TabHost.TAG NAME CH)) ( 
1 = new TabHost () ; 

} 

viewer.repaint(); 

setupRootLayout (1) ; 

AndroidEditor.instance().setLayout (1); 


) 
1; 
layout .addActionListener (layoutActionListener) ; 
tb.add (layout) ; 
p.add (th) ; 
p-setSize (500, 300);// 设置 布局 大 小 
p.validate(); 
jp.setLayout (new BorderLayout ()); 
// 屏幕 分 状 率 种 类 设置 
JComboBox screen size = new JComboBox(new String[] ("320x240", "240x320", "480x320", "320x480", "800x480", "480х800"}); 
Screen size. setSelectedIndex (3); 
JPanel top = new JPanel(); 
FlowLayout fl = new FlowLayout (); 
fl.setAlignment (FlowLayout . LEFT) ; 
top.setLayout (new GridLayout (2,2)); 
top.add (161); 
top.add (layout) ; 
top.add(new JLabel ("AERA HEI") ) 7 
// top.add(new JLabel ("Screen Size:")); 
top.add(screen size); 
p = new JPanel(); 
p.setLayout (#1); 
p.add (сор); 
јр.ада (р, BorderLayout.NORTH); 
jp.add(viewer, BorderLayout.CENTER); 
jp.setBorder (BorderFactory.createTitledBorder ("显示 屏 ")); 
// jp.setBorder (BorderFactory.createTitledBorder ("Screen") ) ; 
JTabbedPane tabs = new JTabbedPane () ; 
tabs.addTab ("Layout", jp); 
static JSplitPane jsp=new JSplitPane(); 
// 添加 程序 设计 区 到 整个 系统 中 
jsp = new JSplitPane(JSplitPane.HORIZONTAL SPLIT, jspll, јр); 
р = new JPanel (); 
FlowLayout £2 = new FlowLayout (); 
f2.setAlignment (FlowLayout .CENTER) ; 
p.setLayout (#2); 
р.ааа (tb) ; 
jp.add(p, BorderLayout . SOUTH) ; 
add (jsp, BorderLayout .CENTER) ; 
// 进行 显示 屏 的 监听 
screen size.addActionListener (пем ActionListener() { 
public void actionPerformed(ActionEvent e) { 
JComboBox jcb = (JComboBox)e.getSource(); 
int ix = jcb.getSelectedIndex(); 
AndroidEditor ae = AndroidEditor.instance(); 
switch (ix) { 
case 0: 
ae.setScreenMode (AndroidEditor.ScreenMode.QVGA LANDSCAPE); 
viewer.resetScreen (ImageResources.instance () .getImage ("emul")); 
break; 
case 1: 
ae.setScreenMode (AndroidEditor.ScreenMode.QVGA PORTRAIT); 
viewer.resetScreen (ImageResources.instance () .getImage ("emu2")); 
break; 
case 2: 
ae.setScreenMode (AndroidEditor.ScreenMode.HVGA LANDSCAPE); 
viewer.resetScreen (ImageResources.instance () .get Image ("emu3")); 
break; 
case 3: 
ae.setScreenMode (AndroidEditor.ScreenMode.HVGA PORTRAIT); 
viewer.resetScreen (ImageResources. instance () .getImage ("emu4") ) 7 
break; 
case 4: 
ae .setScreenMode (AndroidEditor.ScreenMode.WVGA LANDSCAPE); 
viewer. resetScreen (ImageResources. instance () .getImage ("emu5") ) 7 
setSize (1000, 750) ; 
break; 
case 5: 
ae. setScreenMode (AndroidEditor.ScreenMode.WVGA PORTRAIT) ; 
viewer. resetScreen (ImageResources. instance () «getImage ("emu6")); 
setSize (1000, 750); 
break; 


jsp.validate(); 
viewer.repaint(); 
) 
n; 
validate (); 


2) 在 上 述 代码 中 有 一 个 类 Viewer， 它 的 构造 函数 在 目录 org\droiddrawNgui 下 。 这 个 类 实现 了 对 程序 设计 区 中 组 件 的 各 种 监听 控制 。 代 码 如 下 : 


public Viewer (AndroidEditor app, DroidDrawPanel ddp, Image img) { 
this.app = app; 
vl = new ViewerListener (арр, ddp, this); 
addMouseListener (v1); 
addMouseMotionListener (vl); 
addKeyListener (vl); 
app.addChangeListener (this) ; 
this.img = img; 
this.d = new Dimension (480, 480) ; 
dt = new DropTarget (this, DnDConstants.ACTION MOVE, this, true ); 


3) DEA rh REX METS АТА, (RATA AA ТИЈЕЛО, FTR. TER Rorg\droiddraw\guiFA—*ViewerListener, FALASTAHERUR Sih 
监听 的 添加 。 代 码 如 下 : 


package org.droiddraw.gui; 
public class ViewerListener implements MouseListener, MouseMotionListener, KeyListener { 

int off x, off y; 
int sx, sy; 
int grid_x = 10; 
int grid_y = 10; 
boolean select; 
boolean shift; 
int mode; 
private static final 
private static final 
private static final 
private static final 
Viewer viewer; 
AndroidEditor app; 
JComboBox widgetType = new JComboBox(new String[] {AnalogClock.TAG NAME, AutoCompleteTextView.TAG NAME, Button.TAG NAME, CheckBox.TAG NAME, DigitalClock.TAG NAME, EditV 
DroidDrawPanel ddp; z D E Е Е 
private boolean dragging; 
public ViewerListener (AndroidEditor app, DroidDrawPanel ddp, Viewer viewer) { 

this.ddp = ddp; 

this.app = app; 

this.viewer = viewer; 

if (!System.getProperty ("os.name") . toLowerCase () . contains ("mac os x")) 

widgetType.setLightWeightPopupEnabled (false); 


} 
public Component getWidgetSelector() { 
return widgetType; 


} 
public Widget createWidget() { 
String str = (String) widgetType.getSelectedItem (); 
return createWidget (str); 
} 
public static Widget createWidget (String str) { 
if (str.equals (Button.TAG NAME) ) 
return new Button (Button.TAG NAME CH); 
else if (str.equals(CheckBox.TAG NAME)) ~ 
return new CheckBox (CheckBox.TAG NAME CH); 
// 进行 各 种 组 件 判 断 ， 代 码 同 上 所 示 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
else if (str.equals (TabWidget.TAG NAME)) E 
return new TabWidget (); 
else 
return null; 


public void mouseEntered(MouseEvent argO) ( } 
public void mouseExited (MouseEvent arg0) { } 
public void mouseClicked(MouseEvent e) { 
final int x = e.getX()-viewer.getOffX(); 
final int y = e.getY()-viewer.getOffY(); 
final MouseEvent ev = e; 
if (select) { 
final Vector<Widget> ws = app.findWidgets(x, y); 
Widget w = null; 
if (ws.contains (app.getSelected())) { 
w = app.getSelected(); 
// 此 处 添加 了 右键 响应 事件 ， 这 是 为 了 以 后 实现 右键 点 击 的 监听 
if( w instanceof Button ){ 
if (e.isMetaDown () ) { 
// 调用 监听 事件 
EventFrame 工 = new EventFrame (w) ; 
} 
}else if(w instanceof TextView) { 


} 


else { 
switch (ws.size()) { 
case 0: 
break; 
case 1: 
w = ws.get (0); 
break; 
default: 
if (e.isControlDown() || e.getButton() == MouseEvent.BUTTON3) { 
JPopupMenu menu = new JPopupMenu(); 
JMenuItem it = new JMenuItem("Select a widget:"); 
it.setEnabled (false); 
menu. add (it); 
menu.addSeparator () ; 
for (int i=0;i<ws.size();i++) { 
it = new JMenultem(ws.get (i) .getTagName ()); 
final int id = i; 
it.addActionListener (new ActionListener() { 
public void actionPerformed (ActionEvent arg0) { 
doSelect (ws.get (id), ev. getClickCount(), x, y); 
} 
DE 
menu.add (it); 
} 
menu.show(viewer, x, у); 
else { 


w = ws.get (0); 


l 
doSelect(w, e.getClickCount(), x, y); 


else ( 
} 
} 
protected void doSelect (Widget w, int clickCount, int x, int y) { 
if (clickCount > 1) { 
if (w != null) { 
if (w != app.getSelected()) { 
app.select (и); 
l 
ddp.editSelected(); 


} 


(mode == NORMAL ) { 

if (w != null) { 
off_x 
off_y 


else if 


} 
app.select (w) ; 
viewer.requestFocus (); 
viewer.repaint(); 
} 
} 
public void addWidget (Widget ww, int xx, int yy) { 
final int x = xx; 
final int y = yy; 
final Widget w = ww; 


final Vector<Layout> ls = app.findLayouts(x, y); 


Layout 1 = null; 
switch (ls.size()) { 


case 0: 
return; 
case 1: 
1 = 1Is.get (0); 
break; 
default: 


// 当 出 现 选择 控件 放 在 哪个 布局 里 时 出 现 


JPopupMenu menu = new JPopupMenu () ; 


JMenuItem it = new JMenuItem("Select a layout:"); 


it.setEnabled (false); 

menu.add (it); 

menu.addSeparator () ; 

for (int i=0;i<ls.size();it+) { 
it 
final int id = i; 


it.addActionListener (new ActionListener () 
public void actionPerformed (ActionEvent arg0) 

if(FrameLayout.TAG NAME .equals (w.getTagName()) && 
LinearLayout.TAG NAME .equals (1s.get (id) .getTagName ()) 


new JMenulItem(1s.get (i) .getTagName () ) ; 


{ 


addWidget w, ls.get(id), x, y); 


} 
n; 
menu.add (іё); 
} 


menu.show(viewer, x, у); 
l 
if (1 != null) ( 
if (!isTabWidgetValid(l, w)) { 
return; 


} 
addWidget (w, l, x, y); 
} 


} 
// 如 果 Linearlayout 控 件 属于 根 布 局 ， 则 可 以 用 下 列 方法 检测 


private boolean isFrameLayoutForTab (Layout layout, Widget widget) 


boolean found = false; 


{ 


if (!TabHost.TAG NAME.equals ( (app.getLayout () .getTagName () ) ) ) 
AndroidEditor.instance().error( "Please ensure that the root layout is a TabHost layout." ); 


return false; 


} 
Vector<Widget>widgets = app.getLayout () .getWidgets (); 


for (Widget w : widgets) { 


if (LinearLayout.TAG NAME.equals (w.getTagName())) { 


found - true; 
break; 
} 
} 
return found; 


} 


private boolean isTabWidgetValid(Layout layout, Widget widget) { 


// deXdzfti& S| TabWidget, FRM iki AG 09 TabHost Layout 


if (!TabHost.TAG NAME.equals (app.getLayout () .getTagName ()) && 
TabWidget.TAG NAME.equals (widget.getTagName())) { 
AndroidEditor.instance().error( "Please select TabHost as the root layout." ); 


return false; 


} 
if (!(LinearLayout.TAG NAME.equals (layout .getTagName () ) ) 
(TabWidget.TAG NAME.equals (widget.getTagName()))) { 


AndroidEditor.instance().error( "First add a LinearLayout widget to the TabHost Layout. 


return false; 


l 


return true; 


} 
public void addWidget (Widget w, Layout 1, int x, int у) 


{ 


&& 


(w.getParent () !=nullw.getParent ().getScreenX(): 
(w.getParent () !=nullw.getParent ().getScreenY(): 


{ 


$ 


0) *w.getX()-x; 
0) *w.getY () -y; 


boolean prefersGrid = AndroidEditor.instance().getPreferences ().getSnap(); 
if (1 instanceof AbsoluteLayout && ((shift && !prefersGrid) 
w.setPosition((x/grid x)*grid x-l.getScreenX(), 


else 


w.setPosition(x-l.getScreenX(), y-l.getScreenY()); 


1.addWidget (w) ; 


(!shift && prefersGrid) 


(y/grid_y) *grid_y-1.getScreenY ( 


AndroidEditor. instance () .queueUndoRecord (new WidgetAddRecord(l, w)); 


l.applyO; 

app.select (w); 

select - true; 

viewer. requestFocus () ; 
viewer. repaint (); 

// 添加 ui 元 素 到 package 中 


ProjectHandler.instance () .addWidgetDeclare (w) ; 


System.out .Println ("ViewerListener 拖 奥 过 去 后 添加 widget"); 


// 向 树 形 结构 添加 节点 
JTreeView.addUIelement (w) ; 
System. out.println (w.getId()); 


System. out.println ("ViewerListener # 46 % 5 4 X bj Jk 6$ 228 4") ; 


if( w instanceof Button ) { 


&& isFrameLayoutForTab(ls.get(id), w)) { 


)) 
)) 


; 


( (StringProperty) w.getProperties () .get (w.getProperties ().indexOf (w.getPropertyByAttName ("android:id")))).setStringValue ("@android: id/tabcontent") ; 


" + "Then add the TabWidget to that LinearLayout" ); 


ProjectHandler. instance () .getGlzj () .put (w.getId() .substring(5),new HashMap<String, String>()); 


} 


public void mouseReleased(MouseEvent e) { 
dragging - false; 


e.getComponent () . setCursor (Cursor.getPredefinedCursor (Cursor.DEFAULT CURSOR)); 


Widget w = app.getSelected(); 
if (w != null) { 

int nx = w.getX(); 

int ny = w.getY(); 

if (nx != sx || ny != sy) { 


app.queueUndoRecord (new MoveRecord(sx, sy, nx, ny, w)); 


š 
} 


public void mouseDragged(MouseEvent e) { 
int x = e.getX()-viewer.getOffX(); 


int y = e.getY()-viewer.getOffY(); 
if (x < 0) í 
x = 0; 
} 
if (y < 0) í 
y = 0; 


if (x > app.getScreenx () ) 

x = app.getScreenx () ; 
if (у > app.getScreenY () ) 

y = app.getScreenY(); 
Widget selected = app.getSelected(); 
Vector<Widget> ws = app.findWidgets (х, у); 
if (!dragging) ( 

if (!ws.contains(selected)) { 

if (ws.size() > 0) { 


app.select (ws.get (0) ) ; 

selected = app.getSelected(); 

Widget w = selected; 

off_x = 

off y = 

) else ( 
app.select (null); 
return; 


} 

} 

dragging = true; 

if (selected != null) { 
Layout 1 = selected.getParent (); 
Vector<Layout> ls = app.findLayouts (x, y); 
if (ls.size() > 0) { 

int ix = 0; 


do { 
1 = ls.get (ix++); 
} while (1.equals (selected) && ix < ls.size()); 
} 
else 
1 = (selected.getParent ()); 
if (1 != selected.getParent()) { 
if (! (selected instanceof Layout) || ! ( (Layout) selected) .containsWidget (1) ) { 
(selected.getParent ()) . removeWidget (selected); 
1.addWidget (selected) ; 
} 
else { 


1 = selected.getParent (); 


} 
if (mode == NORMAL) { 
e.getComponent () .setCursor (Cursor.getPredefinedCursor (Cursor.MOVE_CURSOR) ) 7 


int nx = (xtoff_x); 

int ny = (ytoff_y); 

boolean prefersGrid = AndroidEditor.instance() .getPreferences(). getSnap(); 

if (1 instanceof AbsoluteLayout && ((shift && !prefersGrid) || (!shift && prefersGrid))) 
nx = nx/grid x*grid x; 


ny - ny/grid y*grid y; 
} 
selected. setPosition (nx-l.getScreenX(),ny-l.getScreenY()); 


else if (mode == E) { 
Widget w = AndroidEditor.instance () .getSelected () ; 
w.setWidth (x- (l.getScreenX () tw.getX()))7 


else if (mode == SE) { 


Widget wd = AndroidEditor.instance().getSelected(); 
int w = x-(l.getScreenX ()+wd.getX ()); 
int h = y-(l.getScreenY () *wd.getY () ) ; 
if (shift) ( 
if (w > h) h = w; 


) 
else w = h; 
} 
wd.setSize (w,h); 
} 
else if (mode — S) ( 
Widget w = AndroidEditor.instance().getSelected(); 
w.setHeight (y- (1.getScreenY ()*w.getY ())) ; 
l 
l.positionWidget (selected); 
1.арр1у(); 
viewer.repaint(); 


} 


l 
// 鼠标 在 组 件 上 移动 监听 ， 可 以 进行 组 件 大 小 的 改变 
public void mouseMoved (MouseEvent ev) { 


) 
// 按键 监听 


int ex = ev.getX(); 
int ey = ev.getY(); 
Widget selected = AndroidEditor.instance() .getSelected() ; 
mode = 0; 
Cursor c = Cursor.getPredefinedCursor (Cursor .DEFAULT_CURSOR) ; 
if (selected != null) { 
int x selected. getParent () .getScreenX () tselected.getX () +viewer.getOf£X (); 
int y selected.getParent () .getScreenY () *selected.getY () *tviewer.getOffY(); 
int distance x = ex - (x*selected.getWidth()); 
int distance y = ey - (у + selected.getHeight ()); 
boolean close r 


if (close r) { 

if (close b) { 
с = Cursor.getPredefinedCursor (Cursor.SE_RESIZE_CURSOR) ; 
mode = SE; 

] 

else { 
с = Cursor.getPredefinedCursor (Cursor.E RESIZE CURSOR); 
mode = E; 


} 


else if (close_b) { 
с = Cursor.getPredefinedCursor (Cursor.S_RESIZE_CURSOR) ; 
mode = S; 

} 


} 
ev.getComponent () .setCursor (c) ; 


public void keyPressed(KeyEvent ev) { 


switch (ev.getKeyCode()) { 
case KeyEvent.VK_SHIFT: 
shift = true; 
break; 
case KeyEvent.VK DELETE: 
case KeyEvent.VK BACK SPACE: 
Widget w = app.getSelected(); 
if (w != null) { 
Layout 1 = w.getParent(); 
app.removeWidget (app.getSelected()); 
app.queueUndoRecord (new WidgetDeleteRecord(l, w)); 
viewer.repaint(); 


} 


break; 

] 

Widget w = app.getSelected(); 

if (w != null && w.getParent() instanceof AbsoluteLayout) { 
int dx = 0; 
int dy = 0; 


switch (ev.getKeyCode()) { 

case KeyEvent.VK UP: 
dy = -1; 
break; 

case KeyEvent.VK_DOWN: 
dy = 1; 7 
break; 

case KeyEvent.VK_LEFT: 
dx = -1; 
break; 

case KeyEvent.VK RIGHT: 
dx = 1; 7 
break; 


} 
if (dx !=0 || dy != O) í 
int sx = w.getX(); 
int sy = w.getY(); 
w.move (dx, dy); 
app .queueUndoRecord (new MoveRecord(sx, sy, sxtdx, sytdy, w)); 


(w.getParent () !=nullw.getParent ().getScreenX(): 0) +w.getX () -x; 
(w.getParent () !=nullw.getParent ().getScreenY(): 0) +w.getY()-y; 


= distance x > -8 && distance x < -1 && ey > y && ey < ytselected. getHeight (); 
boolean close b = distance y > -8 && distance y < -1 && ex > х && ex < x+selected.getWidth(); 


] 
// 鼠标 移 走 监听 
public void keyReleased (KeyEvent ev) { 
switch (ev.getKeyCode()) { 
case KeyEvent.VK_SHIFT: 
shift = false; 
break; 
} 
} 
public void keyTyped (KeyEvent ev) { 


// 和 鼠标 按 下 监听 
public void mousePressed (MouseEvent e) { 

Widget w = app.getSelected(); 

if (w != null) { 
int x = e.getX()-viewer.getOffX(); 
int y = e.getY()-viewer.getOffY(); 
Sx = w.getX(); 
sy = w.getY(); 
off x = (w.getParent () !=nullw.getParent () .getScreenX () :0) +w.getX () —x; 
off_y = (w.getParent () !=nullw.getParent () .getScreenY () :0) +w.getY () -y; 


第 8 章 GPS5Google Map 定 位 系统 


中 又 有 很 多 是 使 用 定位 服务 的 。 移 动 设备 的 优势 就 是 不 受 地 理 位 置 的 限制 ， 如 果 通 过 移动 设备 上 的 Google 地 图 定位 了 自己 所 在 的 位 


移动 设备 上 越 来 越 多 的 应 用 都 要 基于 Google 地 图 ， 而 在 Google 地 图 
， 就 可 以 查询 自己 所 在 位 置 周围 饭店 、 影 院 和 交通 路 线 等 ， 并 通过 GPS 等 方式 把 相关 信息 在 Google 地 图 上 标识 出 来 。 


8.1 MyMap 服 务 系统 


本 章 通 过 一 个 案例 来 介绍 Android 系 统 的 Google Map 和 GPSs 相 关 服 务 ， 启 动 MyMap，Google Map 初 始 界面 截屏 如 图 8-1 所 示 。 


在 图 8-1 所 示 初 始 化 屏幕 中 ， 用 户 可 以 按 下 菜单 键 ， 屏 幕 的 下 方 将 显示 出 菜单 ， 如 图 8-2 所 示 。 


选择 “地 图 模式 ”和 “卫星 模式 ”菜单 ， 可 以 切换 到 地 图 模式 和 卫星 模式 。 图 8-2 所 示 的 地 图 就 是 地 图 模式 ， 卫 星 模式 如 图 8-3 所 示 。 用 户 的 需求 分 析 图 如 图 8-4 所 示 。 
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图 8-3 ”卫星 模式 


需求 分 析 图 中 的 部 分 功能 


“ 选择 地 图 模式 ， 进 入 地 图 模式 。 


“ 选择 卫星 模式 ， 进 入 卫星 模式 。 


“ 定位 查询 ， 通 过 输入 地 点 的 名 称 ， 可 以 定位 到 最 适合 的 一 个 地 点 。 


+ 查询 范围 ， 在 屏幕 范围 查询 出 符合 条 件 的 几 个 地 点 。 


“ 清除 标志 ， 为 了 把 新 查询 的 结果 标识 在 地 图 上 ， 可 以 先 清除 一 些 屏幕 原来 的 标识 。 


图 8-4 ”需求 分 析 


完成 本 章 案例 用 到 的 知识 及 技术 如 下 : 


* Android Google Map; 
` Google Map 图 层 ; 


Android 定 位 服务 。 


8.2 Android Google Map 


Google 地 图 是 Google 公 司 提供 的 电子 地 图 服务 ， 能 提供 3 种 视图 : 一 是 矢量 地 图 (传统 地 


[IR] 
IR] 


) ， 可 提供 行政 区 、 交 通 及 商业 信息 ; 二 是 不 同 分 辨 率 的 卫星 照片 (AW 


图 


[ 


基本 一 样 ) ; 三 是 地 形 视 图 ， 可 以 用 以 显示 地 形 和 等 高 线 。 与 Google 地 图 类 似 的 产品 是 Google Earth， 它 采 


8.2.1 申请 Google Map Android API Key 


使 用 Google Map 的 服务 编写 应 用 程序 ， 需 要 申请 Google Map Android АРІ Key。 它 的 申请 步骤 如 下 。 


1. 找 到 或 创建 keystore 证 书 文 件 


Keystore 证 书 文件 是 随 着 模拟 器 或 真 机 的 创建 或 连接 而 生成 的 ， 本 章 就 不 详细 叙述 了 。 


2. 生 成 MD5 认 证 指纹 


MD5 认 证 指纹 是 对 证 书 文件 的 再 次 加 密 。 把 证 书生 成 MD5 认 证 指纹 过 程 命令 如 下 : 


Keytool ~ list - keystore “C:\Documents and Settings\tony\.android\debug.keystore” 


3D 地 图 


定位 技术 ， 


户 可 以 在 3D 地 


图 


上 搜索 特定 


区 域 。 


与 Google Earth 上 的 卫星 照片 


回 车 后 输入 密码 ， 这 里 密码 是 证 书 加 载 密码 ， 而 非 加 密 密 码 ， 如 果 使 用 的 证 书 文件 是 ADT 生 成 的 debug， 那 么 Keystore 文 件 的 密码 就 是 “android” ， 此 时 输入 的 密码 不 会 有 提示 ， 如 图 8-5 所 示 。 


«c2 ДЕУ Н 1985-2881 Microsoft Corp. 


Documents and Settings Administrator keytool -List -keystore "C-^Documentg an 
Settings Widminietrator’s. android \debuy. keystore” 
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图 8-5 ”生成 MD5 认 证 指纹 


其 中 ， 生 成 的 MD5 认 证 指纹 形式 为 : XX:YY:DShttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/.... 


3. 生 成 Google Map Android API Key 


完成 Key 的 生成 需要 一 个 Google 公 司 的 账号 。 如 果 没 有 ， 可 以 到 Google 公 司 网 站 创建 一 个 。 如 果 这 些 准备 工作 都 已 经 完成 了 ， 就 可 以 生成 Key 了 ， 需 要 在 Google 公 司 网 站 完成 ， 它 的 网 址 是 : 


http://code.Google.com./intl/zn-CN/android/maps-api-signup.html 


打开 网 站 ， 输 入 MD5 认 证 指纹 ， 如 图 8-6 所 示 。 


单 击 “sign”， 登 录 后 产生 如 图 8-7 所 示 的 Key。 


Android Maps APIs Terms of Service 


Last Updated: October 13, 2008 


Thanks for your interest in the Android Maps APIS. The Andiroid Maps 
APIs are a collection af services (including, but nat limited to, the 
"com.qoogle.android.maps.MapView" and "android.location Geocoder" 
classes) that allow you to include maps, geocoding, and other content 
from Google and its content prosiders in your Android applications. The 
Android Maps APIs explicitly do nat include any driving directions data or 
local search data that may be owned ог licensed by Google. 


1. Your relationship with Google. 
1.1. Your use of any of the Android Maps APIs (referred to in this 
document as the "lans APIs)" or the "Service" is subiect to the terms of * 
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图 8-6 ”输入 MD5 认 证 指纹 
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图 8-7 登录 后 产生 的 Key 


注意 : 这 里 要 指出 的 是 Google Map 服 务 已 经 升级 ， 本 文采 用 的 是 v1 版 本 ， 而 v2 和 v3 版 本 的 Key 是 需要 SHA1 来 生成 的 。 具 体 步骤 不 详细 说 明 。 


8.2.2 ”编写 Google Map 框 架 程序 
编写 Google Map 框 架 程序 的 操作 步骤 如 下 : 


1. 创 建 Google АРІ Android 项 目 


通过 右键 菜单 创建 工程 Android 项 


, Google АРІ Android 项 目的 创建 与 


他 的 Android 项 目的 区 别 是 需要 在 新 建 项 目 窗口 


AY "Build Target” 中 选中 “Google APls” 复 选 框 ， 如 图 8-8 所 示 。 


Google APl 是 Android 平 台 的 add-ons (插件 ) ， 如 


图 8-9 所 示 ， 因 此 它 的 


API Level 是 与 Android АРІ Level 一 致 的 ,例如 Google API 的 API Level 是 7 则 说 明 Android 平 台 是 2.1。 
2. 编 写 MapActivity 


编写 要 继承 com.Google.android.maps.MapActivity 类 的 MapActivity， 参 考 如 下 代码 : 


public class MyMapActivity extends MapActivity { 
MapView mapView; 
@Override 
public void onCreate (Bundle savedInstanceState) 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 


{ 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/Text/... 
} 
@Override 


protected boolean isRouteDisplayed() { 
return false; 
} 


} 
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图 8-9 Google API 模 拟 器 


MapAcivity 类 中 有 一 个 抽象 方法 isRouteDisplayed(0， 该 方法 是 告知 Google 服 务 器 我 们 的 应 用 中 是 否 使 用 了 显示 “道路 信息 ”有 关 服 务 ， 如 行车 路 线 等 。 如 果 使 
回 false。 该 方法 是 Google 服 务 条 款 要 求 必须 实现 的 方法 ， 而 且 在 应 用 程序 中 我 们 有 义务 如 实地 返回 true 或 false。 


3. 编 写 MapView 布 局 文件 


与 其 他 的 Android 应 | 


一 样 ， 需 要 在 XML 文件 中 定义 屏幕 布 | 


局 ， 代 码 如 下 : 


服务 则 这 个 方法 就 返回 true， 否 则 返 


<?xml version="1.0" 


encoding-"utf-8"?» 


<LinearLayout xmlns:android="http:// schemas.android.com/apk/res/android" 
android:orientation="vertical" android: layout_width="fill parent" 
android: layout_height="fill_parent"> 
<com.Google.android.maps .MapView 
android: id="@+id/map" android:layout width-"fill parent" 


android:layout height-"fill parent" 
android:apiKey-"4& H Z кеу" /> 
«/LinearLayout» 


在 布局 文件 中 使 


需要 在 这 里 指定 前 


的 <com.Google.android.maps.MapView> 标 签 是 MapView 控 件 ， 


4 增加 Internet 访 问 权限 


在 AndroidManifest.xml 中 增加 Internet 访 问 权 限 ， 代 码 如 下 : 


生成 的 Key。 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http:// schemas.android.com/apk/res/android" 
package-"com.work.map" android:versionCode-"1" android:versionName-"1.0"» 
«application android:icon="@drawable/icon" android:label="@string/app_name"> 

«activity android:name-".MyMapActivity" android:label="@string/app_name"> 
<intent-filter> 
«action апагоіа: пап 
<category android:nam 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name="android.permission. INTERNET" /> 
</manifest> 


droid.intent.action.MAIN" /> 
"android. intent.category.LAUNCHER" /> 


由 于 Google Map 服 务 要 通过 互联 网 ， 


此 要 开放 Internet 访 问 权限 。 


5. 增 加 Google 地 图 函数 库 


在 AndroidManifest.xml 中 增加 Google 地 图 函数 库 ， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http:// schemas.android.com/apk/res/android" 
package-"com.work.map" android:versionCode="1" android:versionName="1.0"> 
<application android:icon="@drawable/icon" android:label="@string/app_name"> 
<uses-library android:name="com.Google.android.maps" /> 
<activity android:name=".MyMapActivity" android:label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name="android.permission. INTERNET" /> 
</manifest> 


除了 开放 Internet 访 问 权限 、 


注册 Activity 外 ， 还 需要 在 AndroidManifest.xml 中 增加 Google 地 图 函数 库 的 声明 。 


这 个 函数 库 的 声明 很 多 初学 者 都 会 忘记 ， 结 果 就 会 出 现 异 常 。 代 码 如 下 : 


Caused by:java.lang.ClassNotoundException:com.work.map.MyMapActivity 
In loader dalvik.system. PathClassLoader@43735570 


823 ”控制 地 图 


编写 完 框 架 代码 后 ， 还 要 实现 其 他 功能 ， 如 移动 地 图 、 放 大 或 缩小 地 图 等 ， 初 步 实现 的 MAP 如 
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8-10 所 示 。 
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8-10 ”初步 实现 的 MAP 


为 了 实现 对 地 图 的 控制 ，Android 提 供 了 MapController 类 ， 通 过 MapController 可 实现 对 地 图 的 移动 、 放 大 或 缩小 等 操作 。 通 过 MapView 对 象 可 以 获得 MapController， 代 码 如 下 : 


MapController mc = mapView.getController(); 


对 于 地 图 的 控制 ， 内 容 包括 : 


* 设 定 地 图 中 心 点 ， 通 过 方法 setCenter (GeoPoint point) 实现 。 


“ 以 动画 方式 移动 地 图 中 心 点 ， 通 过 方法 animateTo (GeoPoint point) 实现 。 


' 设置 地 图 的 缩放 级 别 ， 通 过 方法 setZoom (int zoomLevel) 实现 。 


地 图 的 移动 。 


“ 地 图 的 缩放 。 


1. 地 图 的 基本 控制 


首先 ， 通 过 一 个 案例 介绍 设 定 地 图 中 心 点 、 以 动画 方式 移动 地 图 中 心 点 和 设置 地 图 的 缩放 级 别 。 代 码 如 下 : 


public class MyMapActivity extends MapActivity { 

MapView mapView; 

MapController mc; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
mapView = (MapView) findViewById(R.id.map) ; 
MapController mc = mapView.getController (); 
GeoPoint point = new GeoPoint((int) (39.904214 * 1000000), 

(int) (19.407413 * 1000000) ); 

mc.setCenter (point) ; 
//mc.animateTo (point) ; 
mc.setZoom (14) 7 

} 

@Override 

protected boolean isRouteDisplayed() { 

return false; 
} 
] 


animateTo(GeoPoint) 方 法 可 以 将 地 图 以 动画 的 方式 移动 到 该 位 置 ， 并 把 该 位 置 设 为 地 图 中 心 点 。GeoPoint 是 地 理 坐 标 对 象 ，GeoPoint 类 有 几 个 构造 方法 ， 其 中 常用 的 构造 方法 是 : 表示 一 对 经 度 和 纬度 
值 ， 以 微 度 的 整数 形式 存储 。 


通过 findViewByld 方 法 取得 MapView 控 件 的 实例 ， 再 通过 map.View.getController() 方 法 取得 MapController 的 实例 ， 下 面 就 可 以 通过 setCenter(GeoPoint) 方 法 设置 地 图 的 中 心 点 了 。 
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mc.setZoom(14) 方 法 设置 地 图 缩放 级 别 为 14， 该 方法 可 以 设置 控制 地 图 显示 的 大 小 ， 它 的 取 值 访问 是 1~21 (1 是 全 球 地 图 ，21 是 街道 地 图 ) 。 设 置地 图 缩放 级 别 为 14 的 地 图 截屏 如 图 8-11 所 示 。 


8-11 缩放 级 别 为 14 的 地 图 截屏 


2. 地 | 
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的 移动 和 缩放 


实现 地 图 的 移动 和 缩放 ， 需 要 设置 布局 文件 ， 代 码 如 下 : 


0 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http:// schemas.android.com/apk/res/android" 
android:orientation-"vertical" android:layout width-"fill parent" 
android: layout_height="fill_parent"> 
<com.Google.android.maps .MapView 
android: id="@+id/map" 
android:clickable-"tr 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:apiKey-"O0-cyPyGWOTGfzdXI7TweC9UBkZarkXt21clY 9g" /> 
</LinearLayout> Е 


添加 android:clickable= "true" 属 性 后 ， 还 要 修改 程序 代码 ， 代 码 如 下 : 


public class MyMapActivity extends MapActivity { 
MapView mapView; 
MapController mc; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView (R.layout.main) ; 
mapView = (MapView) findViewById(R.id.map) ; 
mapView.setBuiltInZoomControls (true); 
MapController mc = mapView.getController(); 
GeoPoint point = new GeoPoint((int) (39.904214 * 1000000), 
(int) (19.407413 * 1000000)); 
mc.setCenter (point); 
mc.setZoom(14); 
) 
GOverride 
protected boolean isRouteDisplayed() { 
return false; 
) 
} 


mapView.setBuiltInZoomControls(true) 指 代码 中 可 以 设置 为 缩放 ， 布 局 文件 和 MapActivity 必 须 配 合 使 用 。setBuiltlInZoomControls 是 Android SDK 1.5 版 本 之 后 才 增 加 的 功能 ， 在 此 之 前 要 自己 编 
写 控制 ， 并 在 MapActivity 中 设计 和 添加 放大 和 缩小 按钮 。 当 单 击 地 图 后 会 发 现 屏幕 下 方 出 现 了 缩放 按钮 ， 如 图 8-12 所 示 。 
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图 8-12 ”地 图 缩放 按钮 


8.2.4 地 图 的 显示 模式 


目前 ，Google Map Android API 提 供 了 3 种 显示 模式 : 交通 模式 (Traffic) 、 卫 星 模式 (Satellite) 和 街景 模式 。 前 两 种 模式 可 以 通过 MapView 的 如 下 方式 实现 。 


1. 交 通 模式 (Traffic) 


交通 模式 setTraffic (boolean) 如 果 为 true， 就 打开 交通 线 ， 否 则 关闭 交通 线 。 关 闭 交 通 线 如 图 8-13 所 示 ， 打 开交 通 线 如 图 8-14 所 示 。 


图 8-13 关闭 交通 线 
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卫星 模式 (Satellite) 


setSatellite (boolean) 设置 为 true 情 况 下 的 


图 8-14 ”打开 交通 线 


2 星 模式 如 


8-15 所 示 。 该 模式 下 也 可 以 打开 交通 模式 ， 它 们 可 以 同时 作 | 


8-16 所 示 。 
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图 8-15 ”卫星 + 关闭 交通 
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8-16 ”卫星 + 打开 交通 


下 面 介 绍 交通 模式 与 卫星 模式 组 合 的 例子 ， 代 码 如 下 : 


public class MyMapActivity extends MapActivity { 
MapView mapView; 
MapController mc; 


// UR 

final private int MENU_TRAFFIC1 = Menu.FIRST; // 交通 模式 1 
final private int MENU_TRAFFIC2 = Menu.FIRST + 1; // 交通 模式 2 
final private int MENU_SATELLITE1 = Menu.FIRST + 2; // 卫星 模式 1 


final private int MENU SATELLITE2 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
mapView = (MapView) findViewById(R.id.map) ; 
mapView.setBuiltInZoomControls (true); 
MapController mc = mapView.getController(); 
GeoPoint point = new GeoPoint((int) (39.904214 * 1000000), 
(int) (19.407413 * 1000000)); 
mc.setCenter (point); 
/ /mc.animateTo (point); 
mc.setZoom(14); 


) 

// 建立 菜单 

GOverride 

public boolean onCreateOptionsMenu (Menu menu) ( 
menu.add(0, MENU TRAFFICIl, 0, R.string.trafficl); 
menu.add(0, MENU TRAFFIC2, 0, R.string.traffic2); 
menu.add(0, MENU SATELLITEl, 0, R.string.satellitel); 
menu.add(0, MENU SATELLITE2, 0, R.string.satellite2); 
return super. onCreateOptionsMenu (menu) ; 


} 
// 处 理 菜单 选择 事件 
@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
switch (item.getItemId()) { 
case MENU TRAFFICI: 
mapView. setTraffic (true); 
mapView.setSatellite (false); 
break; 
case MENU TRAFFIC2: 
mapView.setTraffic (false); 
mapView.setSatellite (false) ; 
break; 
case MENU_SATELLITE1: 
mapView.setSatellite (true) ; 
break; 
case MENU SATELLITE2: 
mapView. setSatellite (true); 
mapView.setTraffic (true); 


Menu.FIRST + 3; // 卫星 模式 2 


} 
return super.onOptionsItemSelected (item); 
} 
GOverride 
protected boolean isRouteDisplayed() { 
return false; 
} 
] 


8.2.5 ”地 图 的 图 层 


Ий] 


电子 地 图 的 本 质 就 是 很 多 图 片 的 去 加 和 拼接 ，Google Map 服 务 能 够 根据 用 户 请 求 的 位 置 和 缩放 级 别 返 回 多 个 图 片 然后 拼接 ， 有 时 候 需要 在 地 图 上 添加 一 些 标识 提供 一 些 信息 ， 如 在 一 个 旅游 区 标 出 旅 
游 点 的 位 置 以 及 有 关 该 位 置 的 说 明 ，Google Map 服 务 提供 的 是 基本 的 地 图 图 片 ， 这 样 就 需要 提供 在 地 图 上 放置 图 片 的 方法 ， 并 有 响应 这 些 图 片 的 事件 。 这 里 的 图 片 就 是 图 层 ，Android Google Map 图 层 
类 是 Overlay， 需 要 根据 应 用 的 需要 继承 Overlay 并 履 盖 其 方法 。 在 使 用 的 时 候 ， 也 是 直接 用 Android Google Map API 提 供 的 Overlay 子 类 : ltemizedOverlay 和 MyLocationOverlay。 本 节 
ltemizedOverlay， 在 GPS 定位 时 再 介绍 MyLocationOverlay。 


ltemizedOverlay 是 Overlay 的 一 个 子 类 ， 它 包含 了 一 个 Overlayltem 列 表 ， 处 理 从 南 到 北 的 排序 ， 用 于 绘制 每 个 标记 ， 并 监听 每 个 绘制 点 (Overlayltem) 的 事件 。 下 面 为 案例 添加 图 层 标 识 ， 代 码 如 
T 


private class LocationItemsOverlay extends ItemizedOverlay<OverlayItem>{ 
private List«OverlayItem» items - null; 
private Drawable marker - null; 
public LocationItemsOverlay (Drawable marker, List«OverlayItem» items) ( 
super (marker); 
this.marker - marker; 
this.items - items; 
populate () ; 
] 
GOverride 
protected OverlayItem createItem(int i) { 
return items.get (i); 
} 
GOverride 
public void draw(Canvas canvas, MapView mapView, boolean shadow) { 
super.draw(canvas, mapView, shadow); 
boundCenterBottom (marker); 
) 
улак 
* 
GOverride 
protected boolean onTap(int i) ( 
Toast.makeText (MyMapActivity.this, 
items.get(i).getTitle() + "Wn" + items.get(i).getSnippet (), 
Toast.LENGTH LONG).show(); 
return true; = 
] 
GOverride 
public int size() { 
return items.size(); 


i 


在 案例 中 LocationltemsOverlay 类 继承 了 ltemizedOverlay 类 ， 其 中 有 两 个 成 员 变 量 : 


private List<OverlayItem> items = null;// 保存 OverlayItem 列 表 
private Drawable marker = null;//OverlayItem 的 图 标 


成 员 变 量 items 保 存 绘制 点 图 层 对 象 Overlayltem 列 表 ，Overlayltem 的 构造 方法 为 : 


OverlayItem(GeoPoint point, java.lang.String title, java.lang.String snippet) 


其 参数 为 : point 是 item 的 位 置 ，title 是 该 地 点 的 标题 文本 ，snippet 是 该 地 点 的 简单 描述 。LocationltemsOverlay 对 象 创建 时 初始 化 上 面 的 成 员 变 量 ， 除 了 提供 数据 和 显示 图 标 外 ， 还 调用 populate() 
方法 组 装 数据 ， 调 用 createltem() 方 法 创建 Overlayltem 提 供给 LocationltemsOverlay，size() 方 法 获得 Overlayltem 的 个 数 。 此 外 ， 还 有 draw(0 和 onTap() 方 法 要 详细 介绍 一 下 。 


Draw (Canvas canvas,MapView maoView,Boolean shadow) 方法 为 每 个 item 绘 制 一 个 标记 点 ， 代 码 如 下 : 


GOverride 
public void draw(Canvas canvas, MapView mapView, boolean shadow) ( 
super.draw(canvas, mapView, shadow); 
boundCenterBottom (marker); 


} 
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其 中 参数 canvas 是 画布 对 象 ， 通 过 这 个 对 象 可 以 在 地 图 上 绘制 文字 、2D 


像 和 图 片 等 。mapView 提 供 地 图 所 在 的 MapView 对 象 ，shadow 指 是 否 标识 图 片 有 阴影 ， 如 图 8-17 所 示 为 每 个 标识 图 片 后 画 


区 


都 有 阴影 的 效果 。 注 意 : 这 里 的 原始 标识 图 片 是 没有 阴影 的 


BUER, 


在 draw() 方 法 中 可 以 调 


bound-Centerbottom(marken) 方 法 调整 一 个 drawable (与 
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图 8-17 HA 


片 关联 对 象 ) 的 边界 ， 使 得 绘制 点 
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Æ (0, 0) 为 drawabled 底 
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8-18 所 示 。 
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图 8-18 底层 中 心 


onTap() 方 法 触发 单 击 绘制 点 时 的 事件 ， 代 码 如 下 : 


GOverride 
protected boolean onTap(int i) ( 
Toast.makeText (MyMapActivity.this, 
items.get(i).getTitle() + "Nn" + items.get(i).getSnippet (), 
Toast.LENGTH LONG). show () ; 
return true; 


在 MapView 也 会 有 onTouchEvent 事 件 ， 注 意 这 个 是 触发 地 


件 ， 代 码 如 下 : 


D 
T 


GOverride 
protected boolean onTouchEvent (MontionEvent event,MapView mapView) ( 
return super.onTouchEvent (event,mapView); 


} 


8.2.6 ”查询 与 定位 


在 地 图 上 设置 标识 点 图 层 以 后 ， 就 需要 查询 与 定位 。 相 关 功 能 为 定位 查询 和 查询 周围 。 


先 看 看 定位 查询 功能 ,该 功能 是 通过 对 话 框 输入 ， 获 得 一 个 地 点 。 这 是 通过 地 理 编码 类 (Geocoder) 完成 的 ， 代 码 如 下 : 


private void locate() { 
LayoutInflater factory = LayoutInflater.from(MyMapActivity.this) ; 
View locationView = factory.inflate(R.layout.find dialog, null); 
final EditText findText = (EditText) locationView 
.findViewById(R.id.dailog find); 
new AlertDialog.Builder (this) .SetTitle(R.string.dialog find) .setView( 
locationView) .setPositiveButton (R.string.button ok, 
new DialogInterface.OnClickListener() { B 
public void onClick(DialogInterface dialog, int whichButton) ( 
findString = findText.getText().toString(); 
try { 
Geocoder geocoder - new Geocoder (MyMapActivity.this); 
addresses = geocoder.getFromLocationName (findString, 1); 
if (addresses.size() » O) ( 
List«OverlayItem» overlayitems = new ArrayList«OverlayItem»(); 
double lat = addresses.get (0) .getLatitude () 7 
addresses .get (0) .getLongitude () ; 


centerPoit = new GeoPoint((int) (lat * 1E6), (int) (lng * 1E6)); // 地 理 坐 标 
mc.setCenter (centerPoit) ; 
Log.i(TAG, " lat " + lat +" Ing " + lng); 
int intMaxAddressLineIndex = addresses.get (0) 
-getMaxAddressLineIndex () ; 
String address = "地 址 : "; 
for (int j = 0; j <= intMaxAddressLineIndex; j++) { 


if (addresses.get(0) == null) 
continue; 
address += addresses.get (0) .getAddressLine (j) 


+ 


l 
if (address.endsWith(",")) ( 
address = address.substring(0, address.length() - 1); 
} 
String title = ""; 
if (addresses.get (0) .getFeatureName() == null) { 
title = ""; 
} else { 
title = addresses.get (0) .getFeatureName () ; 
} 
overlayitems.add(new OverlayItem(centerPoit,title, address)); 
Drawable marker = getResources () .getDrawable ( 
R.drawable.markermap2); 
locs = new LocationItemsOverlay (marker, 
overlayitems); 
mapView.getOverlays ().clear(); 
mapView.getOverlays () .add (locs) ; 
} else { 
Toast .makeText (MyMapActivity.this, 
"暂时 无 法 "二 findString + "信息 。"v 
Toast.LENGTH SHORT) . show () 7 


} catch (Exception e) { 
e.printStackTrace () ; 
Toast .makeText (MyMapActivity.this, 
"暂时 无 法 "+ findString + "信息 
Toast.LENGTH SHORT). show() ; 


} 
} 
}) .setNegativeButton (R.string.button_cancel, 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int which) ( 
} 
}) «show () ; 


Android 中 查询 与 定位 是 通过 地 理 编码 类 (Geocoder) 的 getFormLocation 方 法 实现 的 ， 该 方法 有 3 


+ List<.Address>getFromLocation(double latitude,double longitude,int maxResults), ， 通 过 经 纬度 查询 地 点 。 


+ List<Address>getFromLocationName(String locationName,int maxResults,double lowerLeftLatitude,double lowerLeftLongitude,double upperRightLatitude,double upperRightLongitude), ， 通 过 一 个 名 字 并 设 定 一 个 范 
围 查询 地 点 。 


+ List<Address>getFromLocationName(String locationName,int maxResults) ， 通 过 名 字 查询 地 点 。 


其 中 ， 参 数 latitude 是 经 度 ，longitude 是 纬度 ，lowerLeftLatitude 是 查询 范围 的 左下 角 经 度 ，lowerLeftLongitude 是 查询 范围 的 左下 角 纬度 ，upperRightLatitude 是 查询 范围 的 右上 角 经 
度 ，upperRightlongitude 是 查询 范围 的 右上 角 纬度 ，locationName 是 要 查询 的 地 址 名 字 ，maxResults 是 最 大 返回 的 地 点 个 数 。 由 于 同名 的 地 点 很 多 需要 指定 查询 返回 的 个 数 ，Google 推 荐 数量 为 5 个 。 
getFromLocation 方 法 返回 Address 集 合 ，Address 是 Android 平 台 提供 的 地 点 封装 类 ，Address 类 包含 了 很 多 有 关 地 点 的 持久 化 信息 。 


”getLatitude0 ， 返 回 地 点 经 度 。 


“ getLongitude() ， 返 回 地 点 纬度 。 


* String getCounttyCode0 ， 返 回 地 点 所 在 国家 代号 。 


“ String getCountryName() ， 返 回 地 点 所 在 国家 名 称 。 

“ String getFeatureName(0 ， 返 回 地 点 中 有 特色 的 名 字 。 
+ String getPhone0 ， 返 回 地 点 电话 。 

“ String getPostalCode0 ， 返 回 地 点 邮编 。 

+ int getMaxAddressLineIndex( ， 返 回 地 址 的 最 大 行 数 。 


+ String getAddressLine(int index) ， 通 过 索引 返回 地 址 描述 。 


在 本 例 中 通过 getFromLocation 的 两 个 参数 的 方法 查询 地 址 ， 其 中 maxResults 设 定 为 1。 


Geocoder geocoder = new Geocoder (MyMapActivity.this) ; 
addresses = geocoder.getFromLocationName (findString, 1); 


度 ， 通 过 这 个 经 纬度 构造 一 个 Geocoder 对 象 ， 并 将 查询 出 来 的 地 点 作为 
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查询 结果 出 来 之 后 ， 从 List<Address> 中 获得 第 一 个 Address， 当 然 也 是 唯一 的 Address， 地 点 对 象 Address 可 以 获得 
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double lat 
double Ing 
// 设 定 中 心 点 
centerPoit = new GeoPoint((int) (lat * 1E6), (int) (Ing*1E6)); // 地 理 坐 标 
mc.setCenter (centerPoit); 


addresses.get (0) .getLatitude () ; 
addresses .get (0) .getLongitude () ; 


getAddressLine 方 法 和 getMaxAddressLinelndex 方 法 配合 使 用 获得 地 点 地 址 ， 由 于 每 一 个 地 点 地 址 的 字符 多 少 是 未 知 的， 这 些 地址 在 Address 中 是 通过 一 个 Map 存 放 的 ， 需 要 通过 循序 遍历 出 所 有 的 
地 址 ， 并 拼接 成 字符 


Tit 


int intMaxAddressLineIndex = addresses.get (0) .getMaxAddressLineIndex () ; 
String address = "地 址 : "; 
for (int j = 0; j <= intMaxAddressLineIndex; j++) { 
if (addresses.get(0) == null) 
continue; 
address += addresses.get (0) .getAddressLine(j) + ","; 
} 
if (address.endsWith(",")) { 
address = address.substring(0, address.length() - 1); 


把 查询 出 来 的 地 点 Overlayltem 放 入 overlayitems 集 合 中 ， 再 获得 标识 图 片 对 象 marker， 把 这 两 个 对 象 作 为 参数 构建 LocationltemsOverlay 对 象 ，mapView.getOverlays(.add() 方 法 把 
LocationltemsOverlay 对 象 添加 到 地 图 的 图 层 ， 之 前 先 用 mapView.getOverlays().clear() 方 法 清除 历史 上 的 图 层 。 代 码 如 下 : 


overlayitems.add(new OverlayItem(centerPoit,title, address)); 
Drawable marker = getResources () .getDrawable (R.drawable.markermap2) ; 
locs = new LocationItemsOverlay (marker, overlayitems) ; 
mapView.getOverlays().clear(); 

mapView.getOverlays () .add (locs) ; 


运行 定位 查询 功能 ， 在 查询 条 件 中 输入 “北京 大 学 " ， 单 击 “ 确 定 ” 按 钮 ， 如 图 8-19 所 示 。 


查询 结果 用 一 个 图 层 标 识 出 来 ， 如 图 8-20 所 示 。 


单 击 图 层 绘制 点 ， 会 出 现 Toast 提 示 信 息 ， 如 图 8-21 所 示 。 


8-19 ”定位 查询 功能 
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8-20 ”查询 结果 
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图 8-21 提示 信息 


完成 定位 查询 功能 后 ， 接 下 来 介绍 查询 周围 功能 ， 该 功能 通过 一 个 对 话 框 输入 相关 内 容 ， 按 照 该 地 点 查询 当前 屏幕 范围 所 有 有 关 的 地 点 。 例 如 ， 查 询 “ 工 商 银行 ”， 这 个 查询 结果 就 会 很 多 ， 不 仅 要 设 
定 maxResults， 还 要 指定 查询 的 范围 是 当前 屏幕 范围 。 代 码 如 下 : 


/** 


* 查询 周围 
*/ 


private void find() { 
LayoutInflater factory = LayoutInflater.from(MyMapActivity.this) ; 
View locationView = factory.inflate(R.layout.find dialog, null); 
final EditText findText = (EditText) locationView 
.findViewById(R.id.dailog find); 
new AlertDialog.Builder(this).setTitle(R.string.dialog find).setView( 
locationView) .setPositiveButton (R.string.button ok, 
new DialogInterface.OnClickListener() ( = 
public void onClick(DialogInterface dialog, int whichButton) { 
findString = findText.getText() .toString(); 
try { 
Projection projection = mapView.getProjection(); 
Point myPointl = new Point(0, 0); 
DisplayMetrics dm = new DisplayMetrics(); 
getWindowManager () .getDefaultDisplay() .getMetrics ( 
dm) ; 
Point myPoint2 = new Point (dm.widthPixels, 
dm.heightPixels); 
Point myPoint3 = new Point (myPointl.x, myPoint2.y); 
Point myPoint4 = new Point (myPoint2.x, myPointl.y); 
GeoPoint geoPointl = projection.fromPixels( 
myPoint3.x, myPoint3.y); 
Log.i(TAG, " geoPointl " + geoPointl); 
GeoPoint geoPoint2 - projection.fromPixels( 
myPoint4.x, myPoint4.y); 
Log.i(TAG, " geoPoint2 " + geoPoint2); 
Geocoder geocoder - new Geocoder (MyMapActivity.this); 
List<Address> addresses = geocoder 
.getFromLocationName ( 
findText.getText ().toString(),5, 
(double) geoPointl.getLatitudeE6() / 1Е6, 
(double) geoPointl.getLongitudeE6() / 1Е6, 
(double) geoPoint2.getLatitudeE6() / 1E6, 
(double) geoPoint2.getLongitudeE6() / 1E6); 
if (addresses.size() > 0) { 
List<OverlayItem> overlayitems = new ArrayList<OverlayItem>(); 
for (int i = 0; i < addresses.size(); i++) { 


int lat = (int) (addresses.get (i) 
.getLatitude() * 1E6); 
int Ing = (int) (addresses.get (i) 


.getLongitude() * 1E6); 
Log.i(TAG, " lat "+ lat +" lng" + lng); 
int intMaxAddressLineIndex = addresses.get( 
i) .getMaxAddressLineIndex () ; 
String address = "地 址 : "7 
for (int j = 0; j <= intMaxAddressLineIndex; j++) { 
address += addresses.get (i) 
.getAddressLine (j) 
+ ","; 


l 
if (address.endsWith(",")) ( 
address = address.substring(0, address 
.length() - 1); 
} 
GeoPoint pt = new GeoPoint (lat, lng); 
overlayitems.add(new OverlayItem (pt, 
addresses .get (i) .getFeatureName (), 
address) ); 
} 
Drawable marker = getResources () .getDrawable ( 
R.drawable.markermapl); 
locs = new LocationItemsOverlay (marker, 
overlayitems); 
mapView.getOverlays().clear(); 
mapView.getOverlays () .add (locs) ; 
} else { 
Toast .makeText (MyMapActivity.this, 
"暂时 无 法 " + findString + "信息 。"， 
Toast. LENGTH SHORT). show () 7 
š 
} catch (Exception e) { 
e.printStackTrace (); 
Toast .makeText (MyMapActivity.this, 
"暂时 无 法 "+ findString + "48. ", 
Toast .LENGTH SHORT) . show () ; 
} 


}) -setNegativeButton (R.string.button cancel, 

new DialogInterface.OnClickListener() ( 
public void onClick(DialogInterface dialog, int which) ( 
} 

}) .show(); 


要 实现 某 个 范围 的 查询 ， 可 使 用 getFromLocationName(Strirng locationName,int maxResults,double lowerLeftLatitude,double lowerLeftLongitude,double upperRightLatitude,double 
upperRightLongitude) 方 法 ， 该 方法 需要 提供 左下 角 和 右上 和 角 的 经 纬度 ， 当 前 的 屏幕 坐标 很 容易 获得 ， 代 码 如 下 : 


Point myPointl = new Point(0, 0); 

DisplayMetrics dm = new DisplayMetrics(); 

getWindowManager () .getDefaultDisplay ().getMetrics (dm); 

Point myPoint2 = new Point(dm.widthPixels, dm.heightPixels); 
Point myPoint3 = new Point (myPointl.x, myPoint2.y); 

Point myPoint4 = new Point (myPoint2.x, myPointl.y); 


如 何 将 屏幕 坐标 转换 成 为 地 理 坐 标 对 象 呢 ? Android Google Map APl 平 台 提 供 了 com.Google.android.maps.Projection (映射 ) 类 ， 通 过 该 类 实现 屏幕 坐标 和 地 理 坐 标的 转换 。 


通过 mapView 的 formPixels 方 法 可 以 将 屏幕 坐标 转换 成 为 地 理 坐 标 ， 代 码 如 下 : 


Projection projection = mapView.getProjection () 7 
GeoPoint geoPointl = projection.fromPixels (myPoint3.x, myPoint3.y) 
GeoPoint geoPoint2 = projection. fromPixels (myPoint4.x, myPoint4.y) 


通过 mapView 的 toPixels 方 法 可 以 将 地 理 坐标 转换 成 为 屏幕 坐标 ， 代 码 如 下 : 


Point toPixels (GeoPoint in,Point out) 


其 他 代码 与 定位 查询 很 相似 ， 这 里 不 再 介绍 了 ， 下 面 运行 该 功能 ， 输 入 查询 条 件 “ 工 商 银行 ”， 如 图 8-22 所 示 。 
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单 击 “ 确 定 ”按钮 后 查询 出 几 个 结果 ， 并 在 地 图 上 对 应 几 个 图 层 标识 出 来 ， 如 图 8-23| 
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图 8-23 ”查询 结果 


8.3 Android 定 位 服务 


现在 的 移动 设备 很 多 都 提供 定位 服务 ，Android 平 台 目前 支持 两 种 定位 方式 : 


< GPS 定位 ， 通 过 GPS 卫星 定位 ; 


“ 移动 网 络 定位 ， 通 过 移动 运营 商 的 蜂窝 式 移动 电话 基站 或 Wi-Fi 访 问 点 实现 定位 。 


GPS (全 球 定位 系统 ) 是 20 世 纪 70 年 代 由 美国 陆 、 海 、 空 三 军 联合 研制 的 新 一 代 空间 卫星 导航 定位 系统 。 其 主要 目的 是 为 陆 、 海 、 空 三 大 领域 提供 实时 、 全 天 候 和 全 球 性 导航 服务 ， 并 用 于 情报 收集 、 
核 爆 检测 和 应 急 通信 等 一 些 军事 目的 。 经 过 20 余 年 的 研究 实验 ， 耗 资 300 亿 美元 ， 到 1994 年 3 月 ， 全 球 履 盖 概率 高 达 98% 的 24 颗 GPS 卫星 已 布设 完成 。 总 体 来 说 ，GPS 定 位 优点 是 准确 、 覆 盖 面 广阔 ， 缺 点 是 


不 能 被 遮挡 (例如 : 在 建筑 物 里 面 收 不 到 GPS 卫星 信号 ) 、GPS 开 启 后 比较 费 电 。 


HI 


移动 网 络 定位 是 通过 移动 运营 商 的 蜂窝 式 移动 电话 基站 或 Wi-Fi 访 问 点 实现 ， 这 种 定位 方式 误差 比较 大 。 


8.3.4 开启 定位 服务 


在 Android 中 有 很 多 服务 ， 这 些 服务 是 通过 getSystemservice() 方 法 开启 的 。 开 启 定位 服务 的 代码 如 下 : 


private void whereAmI() { 
locationManager = (LocationManager) getSystemService (Context . LOCATION SERVICE); 
locationManager.requestLocationUpdates (LocationManager.GPS_PROVIDER, 1000, 0, mLocationListener) ; 
} 
private LocationListener mLocationListener = new LocationListener() { 
public void onLocationChanged (Location location) { 
double lat = location.getLatitude () 7 
double lng = location.getLongitude () ; 
GeoPoint gp = new GeoPoint((int) (lat * 1E6), (int) (lng * 1E6)); // 地 理 坐标 
mc.animateTo (gp); 


} 

@Override 

public void onProviderDisabled(String provider) { 

} 

@Override 

public void onProviderEnabled(String provider) { 

} 

@Override 

public void onStatusChanged (String provider, int status, Bundle extras) { 


} 


开启 定位 服务 的 关键 语句 用 下 面 的 代码 实现 : 


locationManager = (LocationManager) getSystemService (Context.LOCATION SERVICE); 


服务 启动 之 后 要 注册 定位 服务 监听 器 ， 当 前 的 定位 状态 或 位 置 等 发 生变 化 时 会 向 监听 器 发 出 通知 。 注 册 通 过 requestLocationUpdates 方 法 实现 ， 代 码 如 下 : 


locationManager.requestLocationUpdates (LocationManager.GPS_PROVIDER, 1000, 0, mLocationListener) 7 


第 1 个 参数 是 指 采用 哪 种 定位 服务 方式 ，LocationManager.GPS_PROVIDER 说 明 是 采用 GPSs 定 位 ， 此 外 LocationManager.NETWORK_PROVIDER 是 采用 移动 网 络 定位 ; 第 2 个 参数 是 发 出 通知 的 最 小 
时 间 间 隔 (以 ms 为 单位 ) ; 第 3 个 参数 是 发 出 通知 的 最 小 一 定 距 离 (以 m 为 单位 ) ; 第 4 个 参数 是 服务 器 时 间 监 听 器 ， 需 要 实现 LocationListener 接 口 ， 该 接口 的 方法 为 : 


ublic void onProviderDisabled (String provider) ， 服 务 未 开启 时 回调 该 方法 。 
ublic void onProviderEnabled (String provider) ， 服 务 开启 时 回调 该 方法 。 
ublic void onStatusChanged (String provider,int status,Bundle extras) ， 定 位 服务 状态 发 生变 化 时 回调 该 方法 。 


ublic void onLocationChanged (Location location) ， 定 位 服务 发 生变 化 时 回调 该 方法 ， 这 里 的 变化 是 指 在 requestLocationUpdates 方 法 中 指定 的 最 小 时 间 间 隔 和 最 小 移动 距离 。 


一 般 情况 下 ， 应 用 程序 只 需要 实现 onLocationChanged 人 方法 就 可 以 了 ， 代 码 如 下 : 


public void onLocationChanged(Location location) { 
double lat = location.getLatitude () 7 
double Ing = location.getLongitude () ; 
GeoPoint gp = new GeoPoint((int) (lat * 1E6), (int) (lng * 1E6)); // 地 理 坐 标 
mc.animateTo (gp); 


中 心 点 。 


D 


在 onLocationChanged 方 法 中 ， 参 数 Location 可 以 获得 当前 的 设备 所 在 的 经 纬度 ， 然 后 再 根据 这 个 经 纬度 移动 地 
运行 定位 服务 需要 在 AndroidManifest.xml 中 开放 权限 : 

:android.petmission.ACCESS_COARSE_LOCATION， 移 动 网 络 定位 。 

- android.permission.ACCESS_FINE_LOCATION，GPS 定 位 。 


这 样 在 AndroidManifest.xml 文 件 中 就 有 3 个 权限 开启 了 ， 代 码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http:// schemas.android.com/apk/res/android"package-"com.work.map" android:versionCode-"1" android:versionName-"1.0"»«application android: icon="@drawak 


«uses-library android:name-"com.Google.android.maps" /> 
«activity android:name-".MyMapActivity" android:label-"8string/app name"? 
<intent-filter> = 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
</activity> 
</application> 
«uses-permission android:name="android.permission. INTERNET" /> 


<uses-permission android:name-"android.permission.ACCESS FINE LOCATION" /> 
<uses-permission android:name-"android.permission.ACCESS COARSE LOCATION" /» 
«/manifest» 


8.3.2 ”模拟 测试 


定位 服务 应 用 已 编写 完成 ， 在 没有 真 机 的 时 候 如 何 测试 呢 ? Android SDK 提 供 了 一 个 指令 ， 但 是 要 进入 ADB Shell 中 使 用 ， 比 较 麻烦 。 在 这 里 使 用 Emulator Control， 它 可 以 用 Android SDK 的 tool 目 
录 下 的 ddms.bat 启 动 ， 也 可 以 在 Eclipse 中 使 用 ADT 揪 件 启动 。“Emulator Control” AY "Location Controls” 功 能 可 以 实现 模拟 GPS 坐标 ， 如 图 8-24 所 示 。 
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图 8-24 Emulator Control 


Manual 可 以 发 送 单个 坐标 点 ，GPX 和 KML 可 以 加 载 一 个 具有 对 各 个 坐标 点 的 描述 文件 。 如 图 8-25 所 示 ， 加 载 KML 文 件 后 可 以 发 送 一 连 串 的 坐标 点 ， 并 且 可 以 设 定 这 些 坐标 点 变化 的 速度 。 
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图 8-25 “加载 区 ML 文件 


GPX (GPS Exchange Format) 是 基于 XML 格式 的 ，GPX 可 以 表述 一 组 坐标 点 。KML (Keyhole Markup Language) 由 Google 公 司 发 布 并 主要 应 用 于 Google Earth 客户 端 。KML 描 述 的 功能 很 强 ， 
除了 可 以 描述 一 个 点 的 地 理 坐 标 外 ， 还 可 以 描述 秒 速 线 、 图 片 和 折线 ， 还 可 以 包含 视角 、 高 度 等 信息 。 代 码 如 下 : 


<?xml version-"1.0" encoding="UTF-8"?> 
<kml xmlns="http:// earth.Google.com/kml/2.2"»«Placemark 
<name> 北 京 天 安 门 </name> 
<Point> 
<coordinates>19.408198, 39.904667, 0</coordin: 
</Point> 
</Placemark> 
<Placemark> 
«name» X 01</папе> 
«Point» 
«coordinates»19.408398,39.902667,0«/coordina 
</Point> 
</Placemark> 
<Placemark> 
«name» 3402</name> 
<Point> 
<coordinates>19. 408598, 39.900667, 0</coordin. 
</Point> 
</Placemark> 
<Placemark> 
«name» X 34 03</name> 
<Point> 
<coordinates>19. 408798, 39.898667, 0</coordin 
</Point> 
</Placemark> 
<Placemark> 
«name» 3404</name> 
<Point> 
<coordinates>19. 408998, 39.896667, 0</coordina 
</Point> 
</Placemark> 
<Placemark> 
«name? X J405«/name» 
«Point» 
<coordinates>19. 409198, 39.894667, 0</coordina 
</Point> 
</Placemark> 
<Placemark> 
<name> 3406</name> 
<Point> 
<coordinates>19. 409398, 39.892667, 0</coo: 
</Point> 
</Placemark> 
<Placemark> 
«name» X 3407</name> 
«Point» 
«coordinates»19.409598,39.890667,0«/coordin 
</Point> 
</Placemark> 
<Placemark> 
«name? 3408</name> 
<Point> 
<coordinates>19. 409798, 39.888667, 0</coordin 
</Point> 
</Placemark> 
<Placemark> 
«name» X J&09«/name» 
«Point» 
«coordinates»19.411133,39.882079,0«/coordin 
«/Point» 
</Placemark> 
</km1> 


> 


ates» 


tes» 


ates» 


ates» 


tes» 


tes» 
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<Placemark> 标 签 描 述 的 是 一 个 地 理 坐 标点 ，<name> 标 签 是 这 个 坐标 点 的 名 字 ，< coordinates> 标 签 是 坐标 点 的 经 纬度 。 
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Manual 发 送 单个 坐标 点 后 ， 地 


8.3.3 GPS5Google Map 定 位 


随 着 坐标 点 的 变化 ，GPS 发 出 通知 ， 在 上 面 的 例子 只 能 看 到 地 | 


跳 转 到 发 送 的 坐标 作为 中 心 点 。 如 果 加 载 上 面 的 KML 并 单 击 相应 按钮 图 标 ， 地 图 就 会 移动 。 
图 在 移动 ， 如 何在 移动 的 过 程 中 把 地 图 上 “我 的 位 置 ”标注 成 图 


a 


com.Google.android.maps.MyLocationOverLay 图 层 类 实现 。My 


- 基于 GPS 定位 或 移动 网 络 定 位 ，MyLocationOvetLay 图 层 可 以 指 


“ 基于 指南 针 (Compass) 传感器 只 是 定位 ，MyLocationOverLay 


LocationOverLay 是 Android Google Map API 提 供 的 定位 | 


图 层 对 象 ， 它 可 以 在 地 


IE? Android Google Map API 通 过 


图 中 显示 你 所 在 的 位 置 ， 它 有 如 下 两 个 应 有 


定 你 所 在 的 位 置 ， 可 以 称 之 为 定位 场景 ， 


该 场景 如 图 8-26 所 示 ， 其 中 的 圆 点 还 会 闪烁 ; 


图 层 可 以 指定 方向 ， 可 以 称 之 为 指南 针 场 景 ,但 是 指南 针 要 有 设备 支持 ， 很 多 移动 设备 没有 这 个 功能 ， 模 拟 器 上 无 法 测试 。 
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图 8-26 ”定位 场景 


案例 使 用 GPS 定位 场景 的 MyLocationOverLay 图 层 ， 没 有 使 用 指南 针 场 景 ， 代 码 如 下 : 


** 


* 我 的 位 置 


private void whereAmI() { 


locationManager = (LocationManager) getSystemService (Context .ТОСАТІОМ SERVICE); 


locationManager.requestLocationUpdates (LocationManager.GPS PROVIDER, 1000, 0, mLocationListener) ; 
me = new MyLocationOverlay (this, mapView); 
me.enableMyLocation(); 


mapView.getOverlays () .add (me); 


首先 构造 一 个 MyLocationOverLay 对 象 ， 再 设置 enableMyLocation 
似 的 还 有 方法 enableCompass 开 启 指南 针 更 新 功能 。 对 于 没有 指南 针 功 能 
MyLocationOverLay 图 层 应 用 到 MapView 上 面 。 


来 开启 MyLocation 功 能 ， 并 向 LocationManager.GPS_PROVIDER 和 LocationManager.NETWORK_PROVIDER 注 册 更 新 。 类 
的 手机 ， 不 支持 Compass 的 相关 方法 。 创 建 并 设置 MyLocationOverLay 对 象 后， 通过 map.View.getOverlays0.add(me) 方 法 把 


由 于 使 用 GPS 非 常 费 电 ， 因 此 要 注意 它 的 开启 和 关闭 ， 一 般 情况 下 使 


GPS 的 应 用 ， 应 该 在 onResume() 方 法 中 开启 GPS 服务 ， 代 码 如 下 : 


@Override 

public void onResume() { 
super.onResume () ; 
whereAmI () ; 


在 onPause() 方 法 中 关闭 GPS 服务 ，locationManager.removeUpdates() 方 法 中 移 除 对 GPS 状态 变化 事件 监听 ，me.disableMylocation() 方 法 暂停 GPS 服务 ， 代 码 如 下 : 


GOverride 

public void onPause() ( 
super.onPause(); 
if (locationManager !- null) 


locationManager. removeUpdates (mLocationListener) ; 


} 
if (me != null) { 


me.disableMyLocation () 7 


84 案例 重 构 


н 
Бы 


案例 已 经 完成 了 所 有 功能 ， 但 是 查询 时 屏幕 不 能 动 ， 因 为 查询 需要 访问 Google 服 务 器 ， 是 一 个 耗 时 操作 。 因 此 ， 可 以 添加 子 线程 来 执行 查询 操作 ， 在 查询 过 程 中 再 添加 进度 条 ， 消 除 用户 的 等 待 
8-27 所 示 。 


m 
š 
= 
: 


v^ ami ++ 6:47 


(9 处 理 中 .. 


图 8-27 等 待 处 理 界面 


841 地 图 的 显示 模式 


构 “ 定 位 查询 ”locate() 方 法 ， 增 加 一 个 线程 ， 在 线程 中 处 理 查询 地 点 的 功能 ， 代 码 如 下 : 


private void locate() { 
LayoutInflater factory = LayoutInflater.from(MyMapActivity.this) ; 
View locationView = factory.inflate(R.layout.find_dialog, null); 
final EditText findText = (EditText) locationView _ 
-findViewById(R.id.dailog find); 
new AlertDialog.Builder (this) .setTitle (R.string.dialog_find) .setView( 
locationView) .setPositiveButton (R.string.button ok, 
new DialogInterface.OnClickListener() { N 
public void onClick(DialogInterface dialog, int whichButton) ( 
findString = findText.getText().toString(); 
progDialog = ProgressDialog.show (MyMapActivity.this, 


"处 理 中 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...",，" 定 位" + findString, true, false); 


new Thread() { 
GOverride 
public void run() ( 
try { 
Geocoder geocoder = new Geocoder ( 
MyMapActivity.this); 
addresses - geocoder.getFromLocationName ( 
findString, 1); 
if (addresses.size() > 0) { 
List«OverlayItem» overlayitems = new ArrayList<OverlayItem> () ; 
double lat = addresses.get (0) 
-getLatitude () ; 
double lng = addresses.get (0) 
-getLongitude () ; 
// 设 定 中 心 点 
centerPoit = new GeoPoint((int) (lat * 1E6), 
(int) (Ing * 1E6)); // 地 理 坐 标 
mc.setCenter (centerPoit) ; 
Log.i(TAG, " lat "+ lat +" lng "+ lng); 
int intMaxAddressLineIndex = addresses.get (0) 
-getMaxAddressLineIndex(); 
String address = "地 址 : "; 
for (int j = 0; j <= intMaxAddressLineIndex; j++) { 
if (addresses.get(0) == null) 
continue; 
address += addresses.get (0) 
.getAddressLine(j) 
+ ","; 
} 
if (address.endsWith(",")) { 
address = address.substring(0, 


address.length() - 1); 
) 
String title = ""; 
if (addresses.get(0).getFeatureName() == null) { 
title = ""; 
} else { 


title = addresses.get (0) 
.getFeatureName () ; 
) 
overlayitems.add (new OverlayItem( 
centerPoit, title, address)); 
Drawable marker = getResources () 
-getDrawable ( 
R.drawable.markermap2); 
locs = new LocationItemsOverlay (marker, 
overlayitems); 
handler.sendEmptyMessage (0) ; 
) else ( 
handler.sendEmptyMessage (1) ; 


) catch (Exception e) ( 
e.printStackTrace(); 
handler.sendEmptyMessage (1) ; 

) 

} 
).start(); 


}) -setNegativeButton (R.string.button cancel, 

new DialogInterface.OnClickListener() ( 
public void onClick(DialogInterface dialog, int which) ( 
] 

}) «show () ; 


下 面 的 代码 可 以 实现 显示 进度 条 : 


progDialog = ProgressDialog.show (MyMapActivity.this, "处 理 中 http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...", "j4z" 


启动 一 个 子 线程 ， 在 该 线程 中 实现 地 点 查询 ,但 是 不 能 有 更 新 UI 的 处 理 ， 如 果 查 询 成 功 则 调用 hander.sendEmptyMessage(0)， 如 果 和 失败 则 调用 hander.sendEmptyMessage(1)。 代 码 如 下 : 


New Thread(){ 
@Override 
Public void run() { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15338/OEBPS/' 
} 
} 


Text/... 


在 Hander 的 handleMessage 方 法 中 处 理 更 新 UI 操 作 ， 其 中 ， 成 功 (case0) 时 清除 屏幕 上 原来 的 图 层 ， 重 新 添加 


图 层 ， 最 后 调 有 


关闭 。 


prog.Dialog.dismiss() 方 法 关闭 进度 条 对 话 框 ， 否 则 进度 条 对 话 框 不 会 


private Handler handler = new Handler() { 
@Override 
public void handleMessage (Message msg) { 
switch (msg.what) { 
case 0: 
mapView.getOverlays().clear(); 
mapView.getOverlays () .add (locs) ; 
progDialog.dismiss () 7 
break; 
case 1: 
Toast .makeText (MyMapActivity.this, "暂时 无 法 " + findString + "信息 
Toast.LENGTH SHORT) . show () 7 
progDialog.dismiss(); 


NH 
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519 “查询 周围 ”find() 方 法 ， 增 加 一 个 线程 ， 在 该 线程 中 处 理 查询 地 点 的 功能 ， 代 码 如 下 : 


/** 
* 查询 周转 
x 


private void find() ( 
LayoutInflater factory - LayoutInflater.from(MyMapActivity.this); 
View locationView — factory.inflate(R.layout.find dialog, null); 
final EditText findText = (EditText) locationView 
-findViewById(R.id.dailog find); 
new AlertDialog.Builder (this) .setTitle(R.string.dialog find).setView( 
locationView) .setPositiveButton (R.string .button ok, 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int whichButton) { 
findString = findText.getText ().toString(); 
progDialog = ProgressDialog.show (MyMapActivity.this, 
"AE E sPhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15338/OEBPS/Text/...", "&Ș mitt" + findString, true, fals 
new Thread() ( 
GOverride 
public void run() ( 
try { 
Projection projection - mapView 
-getProjection(); 
Point myPointl = new Point(0, 0); 
DisplayMetrics dm = new DisplayMetrics(); 
getWindowManager () .getDefaultDisplay() 
-getMetrics (ат); 
Point myPoint2 = new Point (dm.widthPixels, 
dm.heightPixels); 
Point myPoint3 = new Point (myPointl.x, 
myPoint2.y); 
Point myPoint4 = new Point (myPoint2.x, 
myPointl.y); 
GeoPoint geoPointl = projection.fromPixels( 
myPoint3.x, myPoint3.y); 
Log.i(TAG, " geoPointl " + geoPointl); 
GeoPoint geoPoint2 = projection.fromPixels( 
myPoint4.x, myPoint4.y); 
Log.i(TAG, " geoPoint2 " + geoPoint2); 
Geocoder geocoder = new Geocoder( 
MyMapActivity.this) ; 
List<Address> addresses = geocoder 
-getFromLocationName ( 
findText.getText () .toString(),5, 


0, 
(double) geoPointl.getLatitudeE6() / 1E6, 
(double) geoPointl.getLongitudeE6() / 1E6, 
(double) geoPoint2.getLatitudeE6() / 1E6, 
( 


(double) geoPoint2.getLongitudeE6() / 1E6); 
if (addresses.size() > 0) { 
List«OverlayItem» overlayitems = new ArrayList«OverlayItem»(); 
for (int i = 0; i < addresses.size(); i++) { 
int lat = (int) (addresses.get (i) 
.getLatitude() * 1E6); 
int lng = (int) (addresses.get (i) 
.getLongitude() * 1E6); 
Log.i(TAG, " lat "+ lat +" 1п "+ lng); 
int intMaxAddressLineIndex = addresses 
.get (i) 
-getMaxAddressLineIndex(); 
String address = "地 址 : "; 
for (int j = 0; j <= intMaxAddressLineIndex; j++) { 
address += addresses.get (i) 
-getAddressline(j)* ","; 


if (address.endsWith(",")) { 
address = address.substring (0, 
address.length() - 1); 


} 
GeoPoint pt = new GeoPoint (lat, lng); 
overlayitems.add(new OverlayItem ( 
pt, addresses.get (i) 
.getFeatureName () , 
address) ); 
} 
Drawable marker = getResources () 
-getDrawable ( 
R.drawable.markermapl); 
locs = new LocationItemsOverlay (marker, 
overlayitems); 
handler.sendEmptyMessage (0) ; 
) else { 
handler.sendEmptyMessage (1) ; 
} 
} catch (Exception e) { 
e.printStackTrace () ; 
handler.sendEmptyMessage (1) ; 
} 
} 
}.start (); 
} 
]).setNegativeButton (R.string.button cancel, 
new DialogInterface.OnClickListener 0 4 
public void onClick(DialogInterface dialog, int which) { 
} 
}) «show () ; 


“查询 周围 ”方法 基本 与 “定位 查询 ”方法 一 样 ， 需 要 在 线程 中 实现 地 点 查询 ， 但 是 不 能 有 更 新 UI 的 处 理 。 而 Hander 的 handerMessage 方 法 中 处 理 更 新 UI 操作 是 与 “定位 查询 ”方法 共用 这 个 处 理 


的 。 


本 章 通过 一 个 地 图 和 GPS 定 位 的 案例 介绍 了 Android Google Map API 和 GPS 服 务 开 发 。 重 点 应 该 掌握 Google Map API 使 用 ， 以 及 在 定位 服务 中 GPS 的 重要 性 。 


第 9 章 Android 图 书 管理 系统 


IR] 


书 的 查询 、 预 约 以 及 挂失 。 管 理 员 通 过 Android 图 书 管理 端 能 够 方便 地 实现 各 类 管理 功能 ， 这 样 极 


本 章 介 绍 学 校 图 书 管理 系统 的 开发 实例 ， 通 过 Android 图 书 管理 系统 ， 学 生 能 够 方便 地 通过 手机 进行 | 
大 地 提高 了 日 常 工作 效率 。 


91 系统 功能 设计 


书 查询 、 借 阅 预约 图 书 、 归 还 挂失 


IR] 
IR] 


书 以 及 挂失 图 书 三 部 分 。 管 理 端的 功能 包括 学 生 管理 、 


R] 
: 
| 


基于 Android 的 图 书 管理 系统 分 为 学 生 端 与 管理 端 两 部 分 ， 学 生 端的 功能 包括 查询 图 书 、 预 约 


书 、 缴 纳 罚 款 ， 以 及 管理 员 管理 共 七 部 分 ， 如 图 9-1 所 示 。 


[I 


图 9-1 系统 功能 设计 


92 ”系统 开发 环境 


系统 采用 Android+ MySQL 数 据 库 进 行 开发 ， 利 用 Eclipse 开发 工具 开发 界面 并 访问 PC 端 MySQl 数 据 库 ， 实 现 数据 的 查询 等 功能 。 图 书 管理 系统 搭建 如 图 9-2 所 示 。 


MySQL Android 设 备 


数据 库 服务 大 


9-2 图 书 管 理 系统 搭建 


其 中 ， 本 系统 JDK 版 本 为 1.6， 采 用 集成 ADT 的 Eclipse 版 本 ， 可 在 ADT 官 网 下 载 ， 版 本 号 为 adt-bundle-windows-x86 64-20131030。Android 模 拟 器 采用 Android 4.4 API 版 本 为 19， 数 据 库 采用 
MySQL 5.6。 


93 数据库 设 计 
图 书 管理 系统 采用 MySQL 数 据 库 对 所 有 数据 进行 管理 ， 系 统 共 有 8 张 表 。 表 9-1 为 学 生 基本 信息 表 ， 学 生 登 录 即 根据 该 表 进行 登录 验证 ， 在 管理 端 中 可 以 对 学 生 信息 表 进行 添加 、 修 改 、 删 除 等 管理 。 


表 9-1 学 生 基 本 信息 表 student 


= É 名 数据 类 型 
S Num Varchar 


иаа [aan] = 
x wem — | —— 2 | 5 
ушш — | — 35 — O 
ушеш | tid 

om ien 
ушш — | — 5 ] 
L— —wüs — | — —H | 
x wem — | — s — ] 
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S Name Varchar 
S Age Varchar 


S Department Varchar 50 院 系 
S_Phone Varchar 电话 


S Permitted Varchar 
S Pwd Varchar 


50 借阅 许可 
20 密码 


表 9-2 为 管理 员 信息 表 ， 除 管理 员 的 1D 与 密码 外 设置 了 管理 员 权 限 字段 ， 通 过 该 字段 区 分 高 级 管理 员 与 普通 管理 员 ， 普 通 管理 员 只 能 修改 自身 的 密码 ， 而 高 级 管理 员 能 够 管理 所 有 的 普通 管理 员 。 


表 9-2 管理 员 信息 表 manager 


* 段 名 & i 
M_Num 管理 员 ID (主键 ) 
M_Permitted 管理 员 权 限 

M, Pwd 密码 


表 9-3 为 图 书信 息 表 ， 图 书信 息 表 包 括 了 图 书 的 唯一 ISBN 编 号 、 书 名 、 作 者 、 出 版 社 ， 以 及 购买 时 间 。 


表 9-3 ”图书 信息 表 book 


FRZ 数据 类 型 备注 
ISBN ISBN (主键 ) 
B Name BA 
B_Author 作者 
Ooo o 
| NENNEN 


B_Publishment 出 版 社 
BuyTime 50 购买 时 间 


表 9-4 为 图 书 明细 表 ， 其 中 标记 了 图 书 的 借阅 与 预约 状态 ， 为 了 便于 图 书 管理 系统 各 功能 的 实现 ， 在 图 书 明细 表 中 定义 了 图 书 的 内 部 编号 作为 主键 ， 在 学 生 端 与 管理 端的 预约 与 借阅 模块 中 使 用 该 表 。 


表 9-4 图 书 明细 表 detailedinformation 


= ю & CENE: 
B Num ТЕЕ 
Borrowed ТЯ 
Ordered ИГ 
>= ПП 


表 9- 5 为 图 书 借阅 信息 表 ， 该 表 以 内 部 编号 为 主键 ， 标 识 了 图 书 的 借阅 情况 ， 包 括 借阅 该 图 书 的 学 生 学 号 、 借 阅 起 始 时 间 、 归 还 时 间 等 信息 ， 另 外 也 标注 了 图 书 的 借阅 标记 与 预约 标记 。 


表 9-5 图 书 借阅 信息 表 record 


NE: gx 
B Num ТЕТУ 
Borrowing DITE 
каматне БЕМ 
Borrowed DITS 
Ordered LOSS 


表 9-6 为 超期 图 书信 息 表 ， 该 表 以 学 号 与 图 书 内 部 编号 为 主键 ， 标 注 了 各 超期 图 书 的 借阅 学 生 姓名 、 书 名 以 及 超期 天 数 。 


表 9-6 超期 图 书信 息 表 overtime 


字 段 名 字段 大 小 


表 9- 7 为 预约 图 


= dt 
学 号 (主键 ) 
书籍 内 部 编号 (主键 ) 
书 名 
超期 天 数 


书信 息 表 。 在 学 生 预 约 图 书 时 ， 系 统 自动 添加 预约 的 图 书信 息 ， 包 括 书号 、 学 生 姓 名 、 班 级 、 书 名 、 学 生 学 号 和 图 书 作者 信息 。 在 管理 端 中 可 以 根据 该 表 查 询 图 书 的 预约 情况 。 


表 9-7 预约 图 书信 息 表 Orderbook 


* Ë 名 数据 类 型 


表 9-8 为 挂失 图 


书信 息 表 ， 学 生 端 可 以 对 借阅 的 图 书 进行 挂失 ， 挂 失 后 ， 自 动 在 挂失 图 书信 息 表 中 添加 一 条 挂失 数据 ， 包 括 挂失 书 编号 、 书 号 、 书 名 以 及 学 生 学 号 。 


表 9-8 挂失 图 书信 息 表 losebook 


* Ë 名 字段 大 小 


在 MySQL 数 据 库 中 ， 使 用 test 数 据 库 实现 以 上 8 个 数据 表 。 


在 应 用 程序 中 ， 


& it 
书号 (主键 ) 
学 生 姓 名 
班级 
А 
学 生 学 号 
作者 
и Ж 
挂失 书 编号 (主键 ) 
书号 
书 名 
学 生 学 号 


为 了 连接 MySQL 数 据 库 ， 需 要 利用 mysql-connector-java-5.1.10-bin.jar 作 为 接口 工具 。 首 先 在 Eclipse 中 依次 选择 Project 一 Java Build Path 一 Libraries， 在 界面 中 选择 Add External 
JARs， 选 择 mysql-connector-java-5.1.10-bin.jar 文 件 将 其 添加 至 工程 中 ， 如 图 9-3 所 示 。 


| d» Properties for StudentBooksysten TT 7C o OHNE UG on xX | | 


type filter text 
Resource 
Android 
Android Lint Preferences 
Builders 
Java Build Path | 
Java Code Style 
Java Compiler 
Java Editor 
Javadoc Location 
Project References 
Refactoring History 
Run/Dehiig Settings 
Tack Tage 
Validation 


在 工程 中 通过 DBUtiljava 文 件 实现 数据 库 的 连接 。 


Public static Connection getConnection () 
{ 

Connection con=null; 

try 

{ 


Java Build Path 


| ( Source | k=; Projects | ЕА Libraries к Order and Export. 
JARs and class folders on the build path: 
| bi mysql-connector-java-5.1.10-binjar - DATES E 06E\S 
mà Android 4.4 
mA Android Dependencies 
BA Android Private Libraries 


“ n h 


e "s v v 


Add JARs... 


Add External JARs... 


Add Variable... 


Add Library... 


Add Class Folder... 


Add Exter nal Class Folder... 


图 9-3 ”添加 jdbc 示 意图 


Class.forName ("org.gjt.mm.mysql.Driver"); 
con-DriverManager.getConnection ("jdbc:mysql:// 127.0.0.1:3306/testuseUnicode- true&characterEncoding=UTF-8", "root", "123456") ; 


} 


catch (Exception e) 


e.printStackTrace (); 
} 


return con; 


其 中 IP 地 址 为 127.0.0.1， 用 户 root 


94 图 书 管理 系统 学 生 端 开发 


941 ”登录 界面 


打开 图 书 管理 系统 学 生 端 登录 界面 ， 输 入 


户 名 和 密码 ， 判 断 


令 为 “123456”。 这 里 需要 将 IP 地 址 改 为 MySQL 数 据 库 服务 器 端的 IP 地 址 。 


户 名 和 密码 正确 自动 进入 图 书 管理 程序 。 学 生 端 登录 界面 如 


9-4 所 示 。 


D 


^ 


代码 给 出 了 登录 按钮 的 具体 功能 ， 在 判断 


户 名 与 密码 的 


匹配 情况 时 ， 利 


<?xml version-"1.0" encoding-"utf-8"?» 


894 ”学生 端 登录 界面 


DBUtil 类 中 的 selectPwd() 方 法 实现 | 


户 名 与 密码 的 匹配 。 


登录 界面 的 设计 过 程 见 源 代 码 ， 下 面 为 了 实现 登录 的 功能 ， 给 出 RootActivityjava 文 件 的 代码 


public void gotoIpView() 
{ 
setContentView (R.layout.main); 
final Button dlu- (Button)this.findViewById (R.id.button01); 
final Button chz= (Button)this.findViewById (R.id.button02); 
final EditText yhm= (EditText) findViewById (R.id.yhm); 
final EditText pwd- (EditText) findViewById (R.id.pwd); 
// 为 登录 按钮 设置 的 监听 
dlu.setOnClickListener ( 
new OnClickListener () 
{ 


GOverride 

public void onClick(View v) ( 
// TODO Auto-generated method stub 
sname-yhm.getText ().toString().trim(); 
String spwd-pwd.getText ().toString().trim(); 
Strin Wd-DBUtil.selectPwd (sname) ; 

System. out.println ("= 
System. out .print (ppwd) ; 
if (spwd.equals (ppwd) ) 

{ 


goToMainMenu () ; 
l 
else 
{ 
Toast .makeText 
( 
RootActivity.this, 
"登录 失败 "， 
Toast.LENGTH SHORT 
).show(); 


} 
); 
chz.setOnClickListener 
( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) 


// goToMainMenu(); 
yhm.setText (""); 
pwd.setText (""); 


} 
); 
curr=WhichView.IP VIEW; 


942 ”查询 界面 


输入 搜索 关键 字 ， 可 以 选择 书 名 查询 、 出 版 社 查询 和 作者 查询 共 3 种 搜索 方法 ， 来 查询 图 书信 息 。 代 码 给 出 了 查询 按钮 的 监听 程序 。 学 生 端 查询 


图 书 界面 如 图 


9-5 所 示 。 


9 ЖЕТУ 
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图 9-5 学 生 端 查询 图 书 界 面 


// 图 书 查询 主 界面 
public void gotoQueryMainView () 
{ 
setContentView(R.layout.self or query); 
// 为 后 退 按钮 设置 的 监听 
ImageButton selfib- (ImageButton)RootActivity.this.findViewById (R.id.ImageButtonself query); 
selfib.setOnClickListener ( ~ 
new OnClickListener () 
{ 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
goback () ; 
} 
} 


); 
// 查询 图 书 的 界面 
Button selfb- (Button)RootActivity.this.findViewById(R.id.self or рок); 
selfb.setOnClickListener( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
gotoQueryView(); 
} 
} 


); 
// 查询 个 人 图 书 界 面 
selfQuery.clear(); 
Button selfbl- (Button) RootActivity.this.findViewById(R.id.self 1 orbutton); 
selfb1.setOnClickListener ( udis 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
selfQuery-DBUtil.getSomeInfo (sname); 
gotoSelfView(); 


} 
); 
curr-WhichView.QUERYMAIN VIEW; 


l 
// 个 人 图 书 的 查询 
public void gotoSelfView() 
{ 
setContentView(R.layout.self query); 
// 为 后 退 按钮 设置 的 监听 
ImageButton selfibl=(ImageButton)RootActivity.this.findViewById(R.id.ImageButtonself_details01); 
selfibl.setOnClickListener( ~ 
new OnClickListener () 
{ 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
goback () ; 


} 
); 
// girdView 
GridView gr-(GridView)RootActivity.this.findViewById (R.id.selfGridViewdetailsO01); 
selfgenerateDataList (selfQuery); 
gr.setAdapter (selfgridView (selfQuery)); 
curr-WhichView.SELF VIEW INFO; 
} 
public void gotoQueryView () 
{ 
setContentView(R. layout .query) ; 
final Spinner ѕр= (Ѕріппег) findViewById (R.id.Spinner01); 
List«CItem > lst = new ArrayList«CItemo(); 
CItem ct = new CItem ("1"," %4"); 
CItem ctl = new CItem ("2"," 作 者 "); 
CItem ct2 = new CItem ("m3"," 出 版 社 "); 
lst.add(ct); 
lst.add (ctl); 
lst.add(ct2); 
ArrayAdapter<CItem > Adapter = new ArrayAdapter«CItem» (RootActivity.this, 
android.R.layout.simple spinner item, 1st); 
sp.setAdapter (Adapter); = Е 
Button sbmit=(Button) findViewById (R.id.querybok) ; 
final RadioButton simpleq- (RadioButton) findViewById (R.id.simpleQuery) ; 
final RadioButton highg= (RadioButton) findViewById (R.id.highQuery) ; 
final EditText simpleEdit- (EditText) findViewById (R.id.simpleQueryEdit); 
final EditText highEditSl EditText) findViewById (R.id.highEditSM); 
final EditText highEditZZ- (EditText) findViewById (R.id.highEditZ2); 
final EditText highEditCBS- (EditText) findViewById (R.id.highEditCBS); 
final LinearLayout simple- (LinearLayout) findViewById (R.id.linearsimple); 
final LinearLayout high- (LinearLayout) findViewById (R.id.linearhigh); 
// ImageButton 后 退 按钮 的 监听 
ImageButton ibquery- (ImageButton) findViewById (R.id. ImageButtonquery) ; 
ibquery.setOnClickListener ( 
new OnClickListener () 
{ 


GOverride 
public void onClick(View v) { 
// TODO Auto-generated method stub 
goback () ; 
} 
} 


); 
// 简单 和 高 级 单 选 按钮 的 单 击 监听 方法 
simpleq.setOnClickListener ( 
new OnClickListener () 
{ 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
simple.setVisibility (1); 
high.setVisibility (-1); 
i 
} 


); 
// 高 级 单 选 按钮 的 单 击 监听 方法 
highq.setOnClickListener( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
simple.setVisibility(-1); 
high.setVisibility (1); 
l 
} 


; 
sbmit.setOnClickListener ( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
// Vector<String> vvvv -new Vector<String>(); 
// 简单 查询 的 事件 监听 
if (simpleq. isChecked () ) 
{ 


String result-simpleEdit.getText ().toString().trim(); 


String id-((CItem)sp.getSelectedItem()).GetID().toString().trim(); 


if (result.equals ("")) 
{ 
Toast .makeText 
( 
RootActivity.this, 
"ARIAS, sain Ж", 
Toast.LENGTH SHORT 
).show() ; 


} 


else 


{ 


resultnumdetails.clear(); 


if (id.equals ("1")) // 通过 输入 书 名 进行 查询 
{ 


queryTOgird-DBUtil.selectAllfrombook (result); 
toast (queryTOgird, resultnumdetails); 
} 


else if (id.equals ("2")) // 通过 作者 进行 查询 


{ 
queryTOgird-DBUtil.getAuthorAllfromBook (result); 

toast (queryTOgird, resultnumdetails); 

} 


else if(id.equals ("3")) // 通过 出 版 社 进行 查询 


{ 
queryTOgird-DBUtil.getPubAllfrombook (result); 
toast (queryTOgird, resultnumdetails); 
} 
} 


} 
else if (highq.isChecked() ) 
{ 


String highSM-highEditSM.getText ().toString().trim( 
String highZZ-highEditZZ.getText ().toString().trim( 
String highCBS=highEditCBS.getText ().toString().tri 


resultnumdetails.clear(); 
if (highSM.equals ("") &&highZZ.equals ("") &&highCBS.equals ("")) 
{ 


Toast .makeText 
( 
RootActivity.this, 
"输入 不 能 全 为 空 ， 请 输入 要 查询 的 内 容 !"， 
Toast.LENGTH SHORT 
).show() ; 


} 
// 书 名 和 作者 的 组 合 查询 


else if((!highSM.equals(""))&&(!highZZ.equals(""))&&(highCBS. equals(""))) 


{ 
queryTOgird-DBUtil.getBnAuAllfrombook (highSM, highZ2); 
toast (queryTOgird, resultnumdetails); 


l 
// 书 名 和 出 版 社 的 组 合 查询 


else if((!highSM.equals ("")) && (high22.equals (""))&&(!highCBS. equals(""))) 


{ 
queryTOgird-DBUtil.getBnCbAllfrombook (highSM, highCBS) ; 
toast (queryTOgird, resultnumdetails) ; 


l 
// 作者 和 出 版 社 的 组 合 查询 


else if((highSM.equals ("") ) && (!highZZ.equals (""))&&(!highCBS. equals(""))) 


{ 
queryTOgird-DBUtil.getAuCbAllfrombook (highZZ, highCBS) ; 
toast (queryTOgird, resultnumdetails) ; 


} 
// 书 名 作者 出 版 社 三 者 的 组 合 查 询 


else if ((!highSM.equals("") ) && (!highZZ.equals("")) &&(!highCBS. equals(""))) 


{ 
queryTOgird-DBUtil.getBnAuCbAllfrombook (highSM, highZZ, highCBS) ; 
toast (queryTOgird, resultnumdetails) ; 
} 
else 
{ 
Toast .makeText 
( 
RootActivity.this, 
"输入 最 多 一 个 为 空 ， 请 输入 要 查询 的 内 容 ! 
Toast.LENGTH SHORT 
).show() ; 


l 
); 
curr=WhichView.QUERY_VIEW; 


943 ”学 生 预 约 管理 


打开 学 生 端 预约 管理 界面 ， 输 入 书号 判断 
约 图 书 ， 界 面 如 图 9-6 所 示 。 


书 是 否 被 借阅 ， 如 果 


D 
D 


D 


书 已 经 被 借阅 ， 则 提示 


ИЙ] 


书 已 经 被 借阅 ， 读 者 可 以 进行 预约 ， 点 击 “ 预 约 ”按钮 ， 完 成 预约 。 预 约 管理 界面 能 够 显示 该 学 生 所 有 的 预 
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图 9-6 学生 端 预 约 管 理 界面 


public void gotoyuyueView () 
{ 


setContentView(R. layout. yuyue) ; 
final EditText yuyueEditSH- (EditText)RootActivity.this.findViewById (R.id.yuyueEditSH); 
Button orderbook- (Button) RootActivity.this. 


findViewBylId(R.id.yuyuequery01) ; // 预约 图 书 的 按钮 
Button managebook= (Button) RootActivity.this. 
findViewById(R.id.yuyuequery02); // 管理 预约 的 按钮 


// ImageButton 后 退 按钮 的 监听 
ImageButton ibyuyue- (ImageButton) findViewById (R.id.ImageButtonyuyue); 
ibyuyue.setOnClickListener( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
goback () ; 


i 
); 
orderbook.setOnClickListener ( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 


// TODO Auto-generated method stub 


bookno=yuyueEditSH.getText () .上 toString () .trim(); 
if (bookno. equals ("") ) 
{ 
Toast .makeText 
( 
RootActivity.this, 
"书号 为 空 ， 请 输入 书号 ! "， 
Toast.LENGTH SHORT 
).show() ; 


else 


yuyuedetailsl.clear(); 
yuyuedetails2.clear(); 
yuyuedetails1=DBUtil.getISinfromdetails (bookno); 
if(yuyuedetailsl.size()--0) 
{ 
Toast .makeText 
( 
RootActivity.this, 
"对 不 起 ， 你 要 预约 的 资料 不 存在 ! ", 
Toast.LENGTH SHORT 
).show() ; 
) 
else if(yuyuedetailsl.get (2) .toString() .equals ("是 ")) 
{ 
Toast .makeText 
( 
RootActivity.this, 
"该 书 已 被 预约 ， 请 选择 其 他 书号 ! ", 
Toast.LENGTH SHORT 
).show() ; 
} 


else 


{ 
yuyuedetails2-DBUtil.getISfrombook (yuyuedetailsl.get (0) .toString() .trim()); 


gotoyuyuedetails (); 
) 


l 
); 
yuyueManagel.clear(); 
// 为 管理 预约 按钮 设置 监听 
managebook.setOnClickListener ( 
new OnClickListener () 
{ 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
yuyueManagel-DBUtil.getBNofromOrder (sname) ; 
if (yuyueManagel . size () ==0) 
{ 


Toast .makeText 
( 
RootActivity.this, 
"你 没有 预约 过 图 书 ， 请 先 预约 图 书 再 进行 管理 ! ", 
Toast.LENGTH SHORT 
).show() ; 
} 


else 
{ 
gotoyuyueManage () ; 


} 
yi 
curr=WhichView.YUYUE_VIEW; 


944 挂失 管理 


D 


显示 该 学 生 的 借阅 记录 ， 可 从 中 选择 要 挂失 的 


书 。 学 生 端 挂失 界面 如 


9-7 所 示 。 


D 
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图 9-7 学 生 端 挂失 界面 


实现 图 书 挂失 功能 的 代码 如 下 : 


public void gotoloseView() 
{ 


setContentView (В. layout. lose) ; 
final EditText tvXH- (EditText)RootActivity.this.findViewById(R.id.loseXH); 
final EditText tvMM- (EditText)RootActivity.this.findViewById (R.id.loseMM); 
final Button loseButtonOk- (Button)RootActivity.this.findViewById (R.id.losebok); 
final Button loseButtonRe- (Button)RootActivity.this.findViewById (R.id.loseresert); 
// 为 后 退 按钮 添加 监听 
ImageButton imagelose- (ImageButton)RootActivity.this.findViewById (R.id.ImageButtonlose); 
imagelose.setOnClickListener( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
goback () ; 
} 
} 


); 
// 为 重 置 按钮 设置 的 监听 
loseButtonRe.setOnClickListener ( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
tvXH.setText ("") ; 
tvMM.setText (""); 


} 
); 
loseInfo.clear(); 
// 为 挂失 按钮 设置 的 监听 
loseButtonOk.setOnClickListener( 
new OnClickListener () 
{ 


GOverride 

public void onClick(View v) ( 
// TODO Auto-generated method stub 
SnameID-tvXH.getText ().toString() .trim(); 
String mm-tvMM.getText ().toString().trim(); 
String ppwd-DBUtil.selectPwd (sname) ; 
if (mm.equals (ppwd)) 
{ 


loseInfo-DBUtil.getSomeInfo (SnameID) ; 
gotoloseinfoView(); 
} 
else 
{ 
Toast .makeText 
( 
RootActivity.this, 
"密码 和 学 号 不 匹配 | ", 
Toast.LENGTH SHORT 
).show(); 


} 
); 
curr=WhichView.LOSE_VIEW; 


95 ”图 书 管理 系统 管理 端 开发 


95.1 登录 界面 


登录 界面 的 实现 方式 与 学 生 端 的 实现 方式 相同 ， 唯 一 不 同 的 是 管理 端的 登录 过 程 中 时 


Tu: 


在 管理 员 信 息 表 中 查询 


户 名 与 密码 。 以 下 给 出 了 管理 端 界面 的 设计 代码 。 


<?xml version=” 1.0” encoding-" utf-8" ?> 


<LinearLayout xmlns:android-" http: //schemas android. com/apk/res/android” 


android:orientation-" vertical" 

android:layout width-" fill parent" 

android:layout | height-" wrap í content” 

android:background-" &ffffff" 

android:gravity-" center" 

> 

<FrameLayout 

android: layout_width=" fill _ parent" 

android:layout height=” 40dip” 

android:background=” @drawable/title” 

> 

<TextView 

android:text=” 

android: layout_width= 
android: layout_height=” fill _parent” 
android: layout_marginTop=” Odip” 
android: layout_marginBottom=”" Odip” 
android: layout_marginLeft=”" Odip” 
android:textSize-" 20dip" 
android:textColor-" #FFFFFE” 
android:textStyle-" bold" 
android:gravity=" center" 


> 

</TextView> 

</FrameLayout> 

<LinearLayout 
android:orientation-" horizontal" 
android:layout width-" „2111 parent" 
android:layout height=” wrap í content” 
android:gravity-" center" 
android:layout marginLeft-" ,Idip" 
android:layout _marginRight=" 7dip" 
android:layout marginTop-" 4dip" 
android:layout | marginBottom-" 4dip” 
android:background=" @drawable/navigator” 


> 
<TextView 

android:text-" ЖЖ” 
android:layout width-" 100dip" 
android:layout height-" wrap content" 
android:id-" @+id/lose” 
android:textSize-" 18dip" 
android:gravity-" center" 
android:textColor-" #FFFFFF” 
android:background-" @drawable/hilight” 

/> 

<TextView 
android:text-" Hs 能 
android:layout width=”100dip” 
android: layout | height=” wrap content" 
android:id-" @+id/yuyue” xd 
android:textSize-" 18dip" 
android:gravity-" center" 
android:textColor-" #FFFFFF” 

/> 

</LinearLayout> 
<LinearLayout 


android: layout_width=” ,fill parent" 
android:layout 1 height-" 200dip" 
android:background-" #аеееее” 
android:orientation-" vertical" 
android:gravity-" center" 
android:layout marginLeft-" 7dip” 
android:layout marginRight-" 7dip" 
> 
<LinearLayout 
android:orientation-" horizontal" 
android:layout width-" fill parent" 
android: layout 1 height=” wrap content" 
android:id-" @+id/linearLayout03” 
android: layout_1 marginLeft= 20px" 
android:background-" #аеееее” 
android: layout_marginTop=" 10dip” 
> 
<TextView 
android:text-" JP £" 
android:layout width-" wrap content" 
android:layout height-" wrap content" 
android:textSize-" 18dip' 
android:textColor-" 4006000" 
/> 
<EditText 
android:id-" @+id/yhm” 
android: layout_width=" ,wrap content” 
android: layout —height=” 40dip” 
android:text=” 
android:textSize-" 16dip” 
android:minWidth-" 180px” 
/> 
</LinearLayout> 
<LinearLayout 
android:orientation-" horizontal" 
android:layout width-" ,fill parent" 
android:layout height-" wrap content" 


android: id=” @+id/linearLayout04 
android: layout_marginLeft=" 20px 
> 
<TextView 
android:text-" % ж ^" 
android: layout width-" wrap content" 
android:layout height-" wrap content" 
android:textSize-" 18dip" 
android:textColor-" #000000” 
/> 
<EditText 
android:id-" @+id/pwd” 
android: layout_width=" wrap content" 
android:layout height-" 40dip" 
android:textSize-" 16dip" 
android:minWidth-" 180px" 
android:password-" true" 
/> 
</LinearLayout> 
<LinearLayout 
android:orientation-" horizontal" 
android:layout width-" fill parent" 
android:layout height-" wrap content" 
android:gravity-" center" 


> 

<Button 

android:text-" ЖЖ” 

android:gravity-" center" 

android:textSize-" 18dip" 

android:layout width-" 80dip" 
android:layout height-" wrap content" 
android:layout marginLeft-" l0dip" 
android:textColor-" #000000” 
android:textStyle-" bold" 
android:id-" @+id/denglu” 


> 
</Button> 
<Button 
android:text-" $ #” 
android:gravity-" center" 
android:layout height-" wrap content" 
android:layout width-" 80dip" 
android:textSize-" 18dip" 
android:layout marginRight-" 10dip” 
android:textColor-" #000000” 
android:textStyle-" bold" 
android:id-" &*id/reset" 
E 
«/Button» 
</LinearLayout> 
</LinearLayout> 
</LinearLayout> 


95.2 ”图 书 管理 
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管理 端 中 图 书 管理 的 功能 包括 图 书 查询 、 图 书信 息 修改 、 图 书 入 库 与 删除 三 部 分 。 其 中 
insertBook 与 deleteBook 实 现 ， 代 码 如 下 : 


书 查询 ， 图 书信 息 修改 与 学 生 端 图 书 查询 功能 类 似 ， 此 处 不 做 过 多 介绍 。 图 书 的 入 库 与 删除 利用 函数 


// 图 书 入 库 
public static void insertBook (String isbn,String BookNo, String BookName, String Author,String Publishment, String BuyTime, String Borrowed,String Ordered,String instroduction) 
{ 
try{ 
Connection con=getConnection () ; 
Statement st=con.createStatement () ; 
String sqll-"insert into book(ISBN,B Name,B Author,B Publishment,B BuyTime) values ('"+isbn+"'," + 


"'"4BookName*" ' , '"+Author+"', '"«Publishment-"', '+BuyTime+"')"; 
String sql2-"insert into bdetailedinformation(B Num, ISBN, Borrowed, Ordered, Introduction) values ('"4BookNot*"'," + 
"'"Hisbne"', '"+Borrowedt+"', '"+Ordered+"', '"*instroduction*t"')"; 


st.executeUpdate (sq11) ; 
st.executeUpdate (sq12) ; 


catch (Exception e) 
{ 

e.printStackTrace (); 
} 


} 

// 删除 图 书信 息 

public static void deleteBook (String bookNO) 

{ 

try{ 
Connection con=getConnection () ; 
Statement st=con.createStatement () ; 
String sql-"delete from bdetailedinformation where B Num='"+bookNO+"'"; 
String sqll-"delete from book where B Num-' -4bookNO-*"'"; 
st.execute (5911); 
st.execute (sql); 


catch (Exception e) 
{ 

e.printStackTrace () ; 
l 


l 
// 修改 图 书信 息 
public static void updateBook (String BookNo, String BookName,String Author, String Publishment, String BuyTime, String Borrowed, String Ordered, String Introduction) 
{ 
try{ 
Connection con=getConnection (); 
Statement st=con.createStatement () ; 
String sql="update bdetailedinformation set B Num='"+BookNot+"',B Name='"+BookName+"',B Author='"+Author+"',B Publishment='"+Publishment+"',B BuyTime='"+BuyTime+"', Borrowed= 
+Borrowed+"', Ordered='"+Ordered+"', Introduction= Introduction+"')"; 
String sql2="update book set B Num='"+BookNot+"',B Name='"+BookName+"',B Author='"+Author+"',B Publishment='"+Publishment+"',B BuyTime='"+BuyTimet+"'"; 
st.executeUpdate (sq12) ; 
st.executeUpdate (sql) ; 


catch(Exception e) 
{ 

e.printStackTrace () ; 
} 

} 


9.5.3 ”学 生 信息 管理 


图 书 管理 系统 管理 端 最 重要 的 功能 之 一 就 是 学 生 信息 的 管理 。 学 生 管 理 模块 中 实现 了 学 生 信 息 的 查询 、 添 加 、 修 改 以 及 删除 等 操作 ， 代 码 如 下 : 


public void gotostumainView () 


setContentView (R. layout.studentmanagementmain) ; 
final RadioButton selectstu= (RadioButton) findViewById (R.id.radiobuttonstudentmanagement selectstu); 
final RadioButton addstu= (RadioButton) findViewById (R.id. radiobuttonstudentmanagerment_insertstu) š 
final EditText stuNoEdit=(EditText)findViewById(R.id.studentmanagementnumberedit);/ 
final EditText stuNameEdit- (EditText) findViewById (R.id.studentmanagementnameedit) ; 
final EditText stuSexEdit- (EditText) findViewById (R.id.studentmanagementxingbieedit); 
final EditText stuQuanxianEdit- (EditText) findViewById (R.id.studentmanagementquanxianedit) ; 
final EditText stuAgeEdit- (EditText) findViewById (R.id.studentmanagementageedit); 
final EditText stuTelEdi EditText) findViewById (R.id.studentmanagementteledit); 
final EditText stuClassEdit- (EditText) findViewById (R.id.studentmanagementclassedit); 


final 
final 
final 
final 
final 
final 
final 


EditText stuXueyuanEdit- (EditText) findViewById (R.id.studentmanagementxueyuanedit) ; 

EditText stuPwdEdit- (EditText) findViewById (R.id.studentmanagementpasswordedit); 

LinearLayout selectlinearlayout- (LinearLayout) findViewById (R.id.studentmanagement selecttulinearlayout); 
LinearLayout addlinearlayout- (LinearLayout) findViewById (R.id.bookmanagement addbooklinearlayout); 

Button add- (Button)this.findViewById(R. id.buttonstudentmanagement insertstu); 

Button select- (Button)this.findViewById (R.id.buttonstudentmanagement selectstu); 

EditText stusnoEdit- (EditText) findViewById(R.id. studentmanagementnumberedit select); 


// ImageButton 后 退 按钮 的 监听 
ImageButton ibstumanagementmain- (ImageButton) findViewById (R.id.ImageButtonstudentmanagement); 
ibstumanagementmain.setOnClickListener ( 
new OnClickListener () 


{ 


} 
Ri 


selectstu. 


GOverride 

public void onClick(View v) ( 
// TODO Auto-generated method stub 
goback () ; 


setOnClickListener ( 


new OnClickListener () 


} 
); 


GOverride 

public void onClick(View v) ( 
// TODO Auto-generated method stub 
selectlinearlayout.setVisibility (1); 
addlinearlayout.setVisibility(-1); 


addstu.setOnClickListener ( 
new OnClickListener () 


{ 


} 


GOverride 

public void onClick(View v) ( 
// TODO Auto-generated method stub 
selectlinearlayout.setVisibility (-1); 
addlinearlayout.setVisibility (1); 

} 


); 
add.setOnClicklistener( 
new OnClickListener () 


{ 


if (temp2 [0 


| [temp2 [4] 


} 


@Оуегг1де 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
temp2 [0]=stuNoEdit.getText () .toString() .trim(); 
tuNameEdit.getText ().toString().trim(); 
tuSexEdit.getText ().toString().trim(); 
temp2 [3]=stuQuanxianEdit.getText ().toString().trim(); 
temp2 [4]=stuAgeEdit.getText () .上 toString () .trim(); 
tuTelEdit.getText () .toString () .trim(); 
tuClassEdit.getText ().toString().trim(); 
temp2[7]-stuXueyuanEdit.getText ().toString().trim(); 
temp2 [8]-stuPwdEdit.getText ().toString() .trim(); 
] .equals ("") | |temp2[1].equals("") | |temp2[2].equals("") ||temp2[3].equals ("") 
-equals("") | |temp2 [5] .equals("") | |temp2[6].equals("") | |temp2[7].equals("") || 
temp2 [8] .equals ("") 
) 


{ 


Toast .makeText 
( 
RootActivity.this, 
"输入 的 信息 不 能 为 空 "， 
Toast.LENGTH SHORT 
).show() ; 
} 
е1ѕе 
1 
gotostuaddView () ; 
} 
l 


select.setOnClickListener ( 
new OnClickListener () 


{ 


} 
); 


@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
String Stuno-stusnoEdit.getText ().toString().trim(); 
tempp-Stuno; 
temp3=DBUtil.selectStu (tempp) ; 
gotostuselectView (); 


curr-WhichView.STUMAIN VIEW; 


} 


954 ”管理 员 管 理 


管理 员 管 理 界面 的 功能 包括 添加 管理 员 和 删除 管理 员 。 与 学 生 管理 不 同 的 是 ， 管 理 员 分 为 两 种 权限 的 管理 员 ， 分 别 为 高 级 管理 员 与 普通 管理 员 ， 高 级 管理 员 能 
理 员 只 能 管理 自己 的 密码 。 以 下 代码 给 出 了 进入 管理 员 界面 ， 添 加 与 删除 管理 员 的 具体 过 程 。 


够 修改 其 他 普通 管理 员 的 信息 ， 而 普通 管 


public void gotoandminmainView () 


{ 


setContentView (R. layout.adminmanagementmain) ; 
final EditText adminname- (EditText) findViewById (R.id.adminnameedit) ; 
Button add- (Button) this. findViewById(R.id.addadmin) ; 
Button delete- (Button) this.findViewById (R.id.deleteadmin); 
final Button select- (Button)this.findViewById (R.id.selectadmin); 
LinearLayout 11= (LinearLayout) findViewById (R.id.adminmainLinearLayout0); 
// ImageButton 后 退 按钮 的 监听 
ImageButton ibadminmanagement- (ImageButton) findViewById (R.id.ImageButtonadminmanagement) ; 
// int a-DBUtil.CheckPermitted (adminname); 
if (permitted!=1) 


{ 


delete.setEnabled (true) ; 
add.setEnabled (true) ; 


else if (permitted==0) 


{ 
delete 


} 


.setEnabled (false) ; 


add. setEnabled (false) ; 


ibadminmanagement .setOnClickListener ( 
new OnClickListener () 


{ 


} 
); 


GOverride 

public void onClick(View v) ( 
// TODO Auto-generated method stub 
goback () ; 


select.setOnClickListener ( 
new OnClickListener () 


GOverride 
public void onClick(View v) ( 


// TODO Auto-generated method stub 
String mgNo-adminname.getText ().toString().trim(); 
temppl-mgNo; 
temp4-DBUtil.SelectAdmin (mgNo) ; 
gotoandminselectView () ; 
} 
} 


); 
add.setOnClicklistener( 
new OnClickListener () 


@Override 
public void onClick(View arg0) { 
// TODO Auto-generated method stub 
gotoadminaddView () ; 
} 
} 


); 
delete.setOnClickListener ( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View arg0) ( 
// TODO Auto-generated method stub 
String mgNo-adminname.getText ().toString().trim(); 
DBUtil.deleteManager (mgNo); 
Toast.makeText 
( 
RootActivity.this, 
"MRAD", 
Toast.LENGTH SHORT 
).show() ; 
gotoandminmainView(); 


] 
); 
curr=WhichView.ADMINMAIN VIEW; 
l 


95.5 ”借阅 预约 图 书 


Ий] 


书 管理 系统 管理 端 中 的 预约 模块 包含 了 学 生 端 中 所 有 的 功能 ， 能 够 查询 学 生 的 预约 情况 ， 在 管理 端 程序 中 实现 了 


Ий] 


书 的 借阅 功能 ， 当 图 书 借阅 成 功 后 系统 及 时 更 新 | 


Ий] 


书 状态 ， 具 体 代码 如 下 : 


public void gotoyuyuedetailde () 
{ 
setContentView (В. layout. yuyuedetailed) ; 
TextView bookname=(TextView) RootActivity.this.findViewBylId(R.id.yuyuebooknametextview) ; 
TextView yuyueauthor- (TextView)RootActivity.this.findViewById (R. id. yuyuebookauthortextview) ; 
TextView yuyuebookpress- (TextView)RootActivity.this.findViewById (R.id.yuyuebookpresstextview); 
TextView yuyueborrow- (TextView)RootActivity.this.findViewById (R. id. yuyuebookborrowtextview) 7 
TextView yuyueorder- (TextView)RootActivity.this.findViewById (R. id. yuyuebookordertextview) ; 

final EditText yuyuestuno- (EditText)RootActivity.this.findViewById (R.id.yuyuestunumber); 
final Button borrow- (Button)RootActivity.this.findViewById (R.id.borrowbook); 
final Button order= (Button) RootActivity.this.findViewById (R.id.orderbook); 
bookname.setText (temp7 [1]) ; 
yuyueauthor.setText (temp? [2]); 
yuyuebookpress.setText (temp7 [3]) ; 
yuyueborrow.setText (temp7 [4]) ; 
yuyueorder.setText (temp7 [5] ) ; 
ImageButton imagelose=(ImageButton)RootActivity.this.findViewById(R.id.ImageButtonyuyuedetails); 
imagelose.setOnClickListener ( 

new OnClickListener () 

{ 

GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
goback() ; 


} 
); 
borrow. setOnClickListener ( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) { 

// TODO Auto-generated method stub 

String StuNO-yuyuestuno.getText ().toString().trim(); 

String orderStuNO=DBUtil.getstu (yuyuetemp) ; 

int a-DBUtil.selectcount (StuNO) ; 

if (StuNO.equals ("")) 

{ 

Toast .makeText 

( 
RootActivity.this, 
"学 号 不 能 为 空 "， 
Toast .LENGTH SHORT 

) .show(); 

} 

else if (a>=borrowbook) 

{ 

Toast .makeText 

( 
RootActivity.this, 
"已 超过 借阅 上 限 ， 不 能 借阅 "， 
Toast.LENGTH SHORT 

).show(); 


l 
else if(temp7[4] .equals ("是 ")) 
{ 
Toast .makeText 
( 
RootActivity.this, 
"此 书 已 经 借阅 ， 不 能 借阅 "， 
Toast.LENGTH SHORT 
).show(); 
} 
else if (сетр7 [4] .equals("$") &&temp7 [5] .equals ("Ж") &&!StuNO. 
{ 
Toast .makeText 


RootActivity.this, 
"此 书 已 经 被 预约 ， 不 能 预约 "， 
Toast.LENGTH SHORT 


).show() ; 
} 
else 
{ 
DBUtil.borrowbook (temp[1],StuNO); 
Toast.makeText 
( 
RootActivity.this, 
"借阅 成 功 "， 
Toast .LENGTH SHORT 
) .show(); 


gotoyuyueView () 7 


} 
} 


Д 
order. setOnClickListener ( 
new OnClickListener () 
{ 
@Override 


equals (orderStuNO)) 


public void onClick(View v) { 
// TODO Auto-generated method stub 
String StuNO=yuyuestuno.getText ().toString().trim(); 
if(temp7[5].equals ("&")) 
{ 


DBUtil.orderbook (temp [1], StuNO) ; 
Toast .makeText 


RootActivity.this, 
"HARA", 
Toast.LENGTH SHORT 
).show() ; 
gotoyuyueView () 7 


] 
} 


); 
curr-WhichView.YUYUEDETAILED VIEW; 
} 


9.5.6 缴纳 罚款 


缴纳 罚款 界面 通过 输入 学 号 ， 查 询 对 应 的 超期 图 书 的 书号 、 书 名 以 及 超期 天 数 ， 并 给 出 需要 缴纳 的 费用 。 成 功 缴纳 罚款 后 系统 显示 缴纳 成 功 并 更 新 缴纳 状态 ， 具 体 代码 如 下 : 


public void gotoFee () 
{ 


setContentView(R. layout. fee) ; 
final Button selectfee= (Button) this. findViewById(R.id.selectfee) ; 
final EditText feestuNo- (EditText) this. findViewBylId (R.id.feestudentnumberedit); 
ImageButton ibfee- (ImageButton) findViewById (R.id.ImageButtonfeel); 
ibfee.setOnClickListener( 

new OnClickListener () 


GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
goToMainMenu () ; 
} 
} 


; 
selectfee.setOnClickListener( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) { 
// TODO Auto-generated method stub 
String feeStuNO-feestuNo.getText ().toString().trim(); 
stunotemp-feeStuNO; 
if (feeStuNO.equals ("")) 
{ 
Toast .makeText 
( 
RootActivity.this, 
"EE READE", 
Toast.LENGTH SHORT 
).show() ; 
Jelse 


{ 
feetodetailed-DBUtil.selectfeeinformation (feeStuNO); 
if (feetodetailed.size()--0) 
{ 
Toast .makeText 
( 
RootActivity.this, 
"没有 查 到 与 你 的 输入 相关 的 资料 ! "， 
Toast.LENGTH SHORT 
).show(); 
) 
else 
{ 
gotobookfeedetailedfrid(); 
} 


l 
curr-WhichView.FEE VIEW; 


} 
public void gotobookfeedetailedfrid() 
{ 
setContentView(R.layout.fee detailed grid); 
GridView gv- (GridView) findViewById (R.id.GridViewfeeO01); 
generateDataListfee (feetodetailed) ; 
gv.setAdapter (gridViewfee (feetodetailed)); 
ImageButton imagefee=(ImageButton) RootActivity.this.findViewById(R.id. ImageButtonfeedetailed) ; 
imagefee.setOnClickListener ( 
new OnClickListener () 
{ 
GOverride 
public void onClick(View v) { 
// TODO Auto-generated method stub 
goback () ; 


// 设置 选项 选中 的 监听 器 

gv.setOnItemSelectedListener ( 
new OnItemSelectedListener () 
{ 


@Override 
public void onItemSelected (AdapterView<> arg0, View argl, 
int arg2, long arg3) ( // 重 写 选项 被 选中 事件 的 处 理 方法 
i 
QOverride 


public void onNothingSelected (AdapterView<> arg0) { } 
} 


// 设置 单 击 监听 
gv.setOnItemClickListener ( 
new OnItemClickListener () 


@Override 
public void onItemClick (AdapterView<> arg0, View argl, int arg2, 
long arg3) ( // 重 写 选项 被 单 击 事件 的 处 理 方法 


LinearLayout 11=(LinearLayout) argl; 
// 获取 当前 选中 选项 对 应 的 LinearLayout 
LinearLayout 12=(LinearLayout) 11.getChildAt (0); 


TextView tvn- (TextView)12.getChildAt (1); // 书号 
LinearLayout 13=(LinearLayout) 11.getChildAt (1); 

TextView tvnl=(TextView) 13.getChildAt (1); // 书 名 
LinearLayout 14=(LinearLayout) 11.getChildAt (2); 

TextView tvn2- (TextView)l4.getChildAt (1); // 日 期 
temp6[0]=tvn.getText () .toString() .trim(); // 书号 
temp6[1]-tvnl.getText () .toString() .trim(); // 书 名 
temp6[2]=tvn2.getText () .toString().trim(); // Kk 


gotofeexianshiView(); 
} 
} 


); 
ImageButton ibfeedatailed- (ImageButton) findViewById (R.id.ImageButtonfeedetailed); 
ibfeedatailed.setOnClickListener ( 
new OnClickListener () 
{ 


GOverride 
public void onClick (View 


v) 


{ 


// TODO Auto-generated method stub 


goToMainMenu () ; 


} 
); 

curr=WhichView.FEE_DRTILED; 
} 
public void gotofeexianshiView () 
{ 
setContentView(R.layout.fee xianshi); 
TextView 
TextView 
TextView 
TextView 
TextView 


stuno- (TextView)RootActivity.this.findViewById (R.id.feebstunumber xianshi02); 
bookno= (TextView)RootActivity.this.findViewById (R.id. feebooknumber xianshi02) E 
bookname= (TextView)RootActivity.this.findViewById (R.id.feebookname xianshi02); 
dalaytime- (TextView)RootActivity.this.findViewById (R.id. feedelaytime xianshi02) $ 
money= (TextView)RootActivity.this.findViewById(R.id.feejiaofei xianshi02); 


final Button bok=(Button)this.findViewById(R.id.feemoney); 


stuno.setText (stunotemp) ; 
bookno.setText (temp6[0]) ; 
bookname.setText (temp6 [1]) ; 
dalaytime.setText (temp6[2]) ; 


money.setText (String.valueOf (0.1*Double.parseDouble (temp6 [2] ) ) 
String.valueOf (0.1*Double.parseDouble (temp6[ 
ImageButton imagefee- (ImageButton)RootActivity.this.findViewByI 


final String str 
imagefee.setOnClickListener( 
new OnClickListener () 
{ 
@Override 
public void onClick (View 


di 
2])); 
d (R. id.ImageButtonfee2); 


v) 


{ 


// TODO Auto-generated method stub 


goback () ; 
} 

} 

); 
bok. setOnClickListener ( 

new OnClickListener () 

{ 

GOverride 


public void onClick(View v) 


{ 


// TODO Auto-generated method stub 
DBUtil.fee(stunotemp, str); 


Toast .makeText 


( 


RootActivity.this, 
"RRRA", 
Toast.LENGTH SHORT 


).show(); 
gotoFee(); 


} 
); 
curr-WhichView.FEE XIANSHI; 
i 
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